Method: geocode.address.geocodeAddressQuery

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

คำขอ HTTP

GET https://geocode.googleapis.com/v4alpha/geocode/address/{addressQuery}

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

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

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

string

ที่อยู่ที่ไม่มีโครงสร้างเพื่อเข้ารหัสพิกัดภูมิศาสตร์
สิ้นสุดฟิลด์ที่แยกกัน

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

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

object (GeocodeAddressRequest.LocationBias)

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

string

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

string

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

object (PostalAddress)

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

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

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

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

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

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

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