Method: geocode.location.geocodeLocationQuery

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

คำขอ HTTP

GET https://geocode.googleapis.com/v4beta/geocode/location/{locationQuery}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

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

string

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

พารามิเตอร์การค้นหา

พารามิเตอร์
languageCode

string

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

string

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

string

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

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

enum (Granularity)

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

object (LatLng)

สถานที่ตั้งในรูปแบบ Structured Data

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ GeocodeLocationResponse

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

ต้องใช้ขอบเขต 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