Package google.maps.geocode.v4beta

ดัชนี

GeocodeService

บริการสำหรับการเข้ารหัสพิกัดภูมิศาสตร์

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

วิธีนี้จะดำเนินการรหัสพิกัดภูมิศาสตร์ของที่อยู่ ซึ่งจะแมปที่อยู่กับ LatLng นอกจากนี้ยังให้ข้อมูลที่มีโครงสร้างเกี่ยวกับที่อยู่ด้วย

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

วิธีนี้จะดำเนินการ Geocode ตำแหน่ง ซึ่งจะแมป LatLng กับที่อยู่ นอกจากนี้ยังให้ข้อมูลที่มีโครงสร้างเกี่ยวกับที่อยู่ด้วย

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

วิธีนี้จะทำการค้นหา Geocode โดยใช้รหัสสถานที่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place

GeocodeAddressRequest

ข้อความคำขอสำหรับ GeocodeService.GeocodeAddress

ช่อง
location_bias

GeocodeAddressRequest.LocationBias

ไม่บังคับ ภูมิภาคที่จะค้นหา ตำแหน่งนี้ทำหน้าที่เป็นอคติ ซึ่งหมายความว่าระบบอาจแสดงผลลัพธ์ที่อยู่รอบๆ ตำแหน่งที่ระบุ

language_code

string

ไม่บังคับ ภาษาที่ควรแสดงผลลัพธ์

region_code

string

ไม่บังคับ รหัสภูมิภาค รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") 2 อักขระ พารามิเตอร์นี้จะส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง พารามิเตอร์นี้จะส่งผลต่อผลลัพธ์จากบริการด้วย แต่จะไม่จำกัดผลลัพธ์ทั้งหมด

ฟิลด์ Union address_input ที่อยู่ที่ต้องการเข้ารหัสพิกัดภูมิศาสตร์ address_input ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
address_query

string

ที่อยู่ที่ไม่มีโครงสร้างที่จะเข้ารหัสพิกัดภูมิศาสตร์

address

PostalAddress

ที่อยู่ที่มีโครงสร้างเพื่อเข้ารหัสพิกัดภูมิศาสตร์ในรูปแบบที่อยู่ไปรษณีย์

LocationBias

ภูมิภาคที่จะค้นหา ตำแหน่งนี้ทำหน้าที่เป็นอคติ ซึ่งหมายความว่าระบบอาจแสดงผลลัพธ์ที่อยู่รอบๆ ตำแหน่งที่ระบุ

ช่อง
ฟิลด์ Union type ประเภทของอคติทางภูมิศาสตร์ type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rectangle

Viewport

กล่องสี่เหลี่ยมผืนผ้าที่กำหนดโดยมุมตะวันออกเฉียงเหนือและตะวันตกเฉียงใต้ rectangle.high() ต้องเป็นจุดทางตะวันออกเฉียงเหนือของสี่เหลี่ยมผืนผ้าใน Viewport rectangle.low() ต้องเป็นจุดทางตะวันตกเฉียงใต้ของวิวพอร์ตสี่เหลี่ยมผืนผ้า rectangle.low().latitude() ต้องไม่เกิน rectangle.high().latitude() ซึ่งจะส่งผลให้ช่วงละติจูดว่างเปล่า วิวพอร์ตสี่เหลี่ยมผืนผ้าต้องกว้างไม่เกิน 180 องศา

GeocodeAddressResponse

ข้อความตอบกลับสำหรับ GeocodeService.GeocodeAddress

ช่อง
results[]

GeocodeResult

ผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์

GeocodeLocationRequest

ข้อความคำขอสำหรับ GeocodeService.GeocodeLocation

ช่อง
language_code

string

ไม่บังคับ ภาษาที่ควรแสดงผลลัพธ์

region_code

string

ไม่บังคับ รหัสภูมิภาค รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") 2 อักขระ พารามิเตอร์นี้จะส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

types[]

string

ไม่บังคับ ชุดแท็กประเภทเพื่อจำกัดผลลัพธ์ ระบบจะนำผลลัพธ์ที่ไม่มีประเภทที่ระบุออก

ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ตาราง ก. และตาราง ข. ใน https://developers.google.com/maps/documentation/places/web-service/place-types

granularity[]

GeocodeResult.Granularity

ไม่บังคับ ตัวกรองของ Enum ความละเอียดของสถานที่อย่างน้อย 1 รายการ

ฟิลด์ Union location_input สถานที่ตั้งที่จะเข้ารหัสพิกัดภูมิศาสตร์ location_input ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
location_query

string

ตำแหน่งในรูปแบบสตริง "lat,lng" เช่น "64.7611872,-18.4705364"

location

LatLng

สถานที่ตั้งในรูปแบบที่มีโครงสร้าง

GeocodeLocationResponse

ข้อความตอบกลับสำหรับ GeocodeService.GeocodeLocation

ช่อง
results[]

GeocodeResult

ผลลัพธ์การเข้ารหัสพิกัดภูมิศาสตร์

plus_code

PlusCode

Plus Code ของสถานที่ตั้งในคำขอ

GeocodePlaceRequest

ข้อความคำขอสำหรับ GeocodeService.GeocodePlace

ช่อง
place

string

ต้องระบุ ตัวระบุสถานที่ที่จะแปลงเป็นพิกัดภูมิศาสตร์ในรูปแบบ places/{place}

language_code

string

ไม่บังคับ ภาษาที่ควรแสดงผลลัพธ์

region_code

string

ไม่บังคับ รหัสภูมิภาค รหัสภูมิภาคที่ระบุเป็นค่า ccTLD ("โดเมนระดับบนสุด") 2 อักขระ พารามิเตอร์นี้จะส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

GeocodeResult

ผลลัพธ์ของ Geocode มีข้อมูลทางภูมิศาสตร์เกี่ยวกับสถานที่

ช่อง
place

string

ตัวระบุสถานที่ที่สมบูรณ์สำหรับผลลัพธ์นี้ ในรูปแบบ "//places.googleapis.com/places/{placeID}" ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/place-id

place_id

string

รหัสสถานที่สำหรับผลการค้นหานี้

location

LatLng

ละติจูด ลองจิจูดของที่อยู่นี้

granularity

GeocodeResult.Granularity

ระดับความละเอียดของตำแหน่ง

viewport

Viewport

วิวพอร์ตที่เหมาะสําหรับการแสดงผลลัพธ์รหัสพิกัดภูมิศาสตร์

bounds

Viewport

กรอบล้อมรอบที่อยู่

formatted_address

string

ที่อยู่ที่จัดรูปแบบเป็นบรรทัดเดียว

postal_address

PostalAddress

ที่อยู่ในรูปแบบที่อยู่ทางไปรษณีย์

address_components[]

GeocodeResult.AddressComponent

คอมโพเนนต์ที่ซ้ำกันสำหรับระดับสถานที่แต่ละระดับ

postal_code_localities[]

LocalizedText

รายการสถานที่ทั้งหมดที่อยู่ในรหัสไปรษณีย์

ระบบจะป้อนข้อมูลนี้เมื่อผลลัพธ์เป็นประเภท "postal_code" เท่านั้น

types[]

string

ชุดแท็กประเภทสำหรับผลการค้นหานี้ เช่น "political" และ "administrative_area"

ดูรายการค่าที่เป็นไปได้ทั้งหมดได้ที่ตาราง ก. และตาราง ข. ใน https://developers.google.com/maps/documentation/places/web-service/place-types

plus_code

PlusCode

Plus Code ของสถานที่ในพิกัดภูมิศาสตร์นี้

AddressComponent

คอมโพเนนต์ที่มีโครงสร้างซึ่งประกอบกันเป็นที่อยู่ที่จัดรูปแบบแล้ว หากมีข้อมูลนี้

ช่อง
long_text

string

คำอธิบายข้อความแบบเต็มหรือชื่อของคอมโพเนนต์ที่อยู่ เช่น คอมโพเนนต์ที่อยู่สำหรับประเทศออสเตรเลียอาจมีชื่อยาวว่า "ออสเตรเลีย"

short_text

string

ชื่อข้อความแบบย่อของคอมโพเนนต์ที่อยู่ (หากมี) เช่น คอมโพเนนต์ที่อยู่สำหรับประเทศออสเตรเลียอาจมีชื่อย่อเป็น "AU"

types[]

string

อาร์เรย์ที่ระบุประเภทของคอมโพเนนต์ที่อยู่

ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types

language_code

string

ภาษาที่ใช้ในการจัดรูปแบบคอมโพเนนต์นี้ในรูปแบบ CLDR

รายละเอียด

ระดับความละเอียดของตำแหน่ง

Enum
GRANULARITY_UNSPECIFIED โปรดอย่าใช้
ROOFTOP ตำแหน่งที่ไม่ได้ประมาณค่าของแปลงที่ดินจริงซึ่งตรงกับที่อยู่ที่ตรงกัน
RANGE_INTERPOLATED ประมาณค่าจากช่วงหมายเลขถนน เช่น หากเรารู้ว่าส่วนหนึ่งของ Amphitheatre Pkwy มีหมายเลข 1600-1699 เราอาจวางหมายเลข 1650 ไว้กึ่งกลางระหว่างจุดสิ้นสุด
GEOMETRIC_CENTER จุดศูนย์กลางทางเรขาคณิตของฟีเจอร์ที่เรามีข้อมูลรูปหลายเหลี่ยม
APPROXIMATE อื่นๆ ทั้งหมด

PlusCode

Plus Code (http://plus.codes) คือการอ้างอิงตำแหน่งที่มี 2 รูปแบบ ได้แก่ รหัสสากลที่กำหนดสี่เหลี่ยมผืนผ้าขนาด 14x14 เมตร (1/8000 ขององศา) หรือเล็กกว่า และรหัสผสมที่แทนที่คำนำหน้าด้วยตำแหน่งอ้างอิง

ช่อง
global_code

string

รหัสสากล (แบบเต็ม) ของสถานที่ เช่น "9FWM33GV+HQ" ซึ่งแสดงพื้นที่ขนาด 1/8000 x 1/8000 องศา (~14 x 14 เมตร)

compound_code

string

รหัสผสมของสถานที่ เช่น "33GV+HQ, Ramberg, Norway" ซึ่งมีคำต่อท้ายของรหัสสากลและแทนที่คำนำหน้าด้วยชื่อที่จัดรูปแบบของเอนทิตีอ้างอิง