ข้อมูลอ้างอิงโดยย่อของ Geocoding API

Geocoding API เป็นบริการบนเว็บที่แปลงที่อยู่เป็นพิกัดและรหัสสถานที่ รวมถึงแปลงพิกัดหรือรหัสสถานที่ให้เป็นที่อยู่ นอกจากนี้ เมธอด v4 SearchDestinations ยังแสดงรายละเอียดปลายทาง เช่น ทางเข้าอาคาร จุดนำทาง โครงร่างอาคารและพื้นที่ และจุดสังเกตใกล้เคียง

Geocoding API: ข้อเท็จจริงสำคัญ

  • ผลิตภัณฑ์: Geocoding API
  • หมวดหมู่: สถานที่
  • แพลตฟอร์ม: บริการผ่านเว็บ (REST)
  • ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Geocoding API

Geocoding API: กรณีที่ควรใช้

ใช้ Geocoding API ในกรณีต่อไปนี้

  • คุณต้องแปลงที่อยู่เป็นพิกัดละติจูด/ลองจิจูดและรหัสสถานที่ในเซิร์ฟเวอร์แบ็กเอนด์
  • คุณต้องมีที่อยู่หรือเขตบริหาร (เมือง รหัสไปรษณีย์) ที่แสดงสำหรับพิกัด GPS หรือรหัสสถานที่ที่รู้จัก
  • คุณต้องมีทางเข้าอาคาร จุดนำทางที่กำหนดเส้นทางได้ หรือโครงร่างอาคาร/พื้นที่เพื่อนำทางคนขับหรือผู้จัดส่งไปยังจุดหมาย
  • คุณต้องระบุจุดหมายภายในอาคารขนาดใหญ่ (สนามบิน ห้างสรรพสินค้า วิทยาเขต) เป็นจุดหมายย่อยหรือจุดสังเกตใกล้เคียง

อย่าใช้ Geocoding API ในกรณีต่อไปนี้

  • คุณต้องใช้การเข้ารหัสพิกัดภูมิศาสตร์จาก JavaScript ของเบราว์เซอร์ฝั่งไคลเอ็นต์ การเรียกใช้ v4 ด้วยคีย์ API ที่เปิดเผยถือเป็นความเสี่ยงด้านความปลอดภัย โปรดใช้ Maps JavaScript API แทน
  • คุณต้องคำนวณเส้นทางหรือเวลาถึงโดยประมาณไปยังปลายทางที่เข้ารหัสพิกัดภูมิศาสตร์ โปรดใช้ Routes API แทน
  • คุณต้องการคำแนะนำแบบเลี้ยวต่อเลี้ยวไปยังโทเค็นจุดนำทางในแอป Android ให้ใช้ Navigation SDK สำหรับ Android แทน
  • คุณต้องการคำแนะนำแบบเลี้ยวต่อเลี้ยวไปยังโทเค็นจุดนำทางในแอป iOS ให้ใช้ Navigation SDK สำหรับ iOS แทน

Geocoding API: การตั้งค่า

Geocoding API: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: คำขอ SearchDestinations ที่ไม่มีฟิลด์มาสก์จะดำเนินการไม่สำเร็จและแสดงข้อผิดพลาด ฟิลด์มาสก์เป็นฟิลด์ที่จำเป็น ซึ่งแตกต่างจาก GeocodeAddress, GeocodeLocation และ GeocodePlace วิธีแก้ไข: ตั้งค่าส่วนหัว X-Goog-FieldMask หรือพารามิเตอร์ $fields ในคำขอ SearchDestinations ทุกรายการ ดู /maps/documentation/geocoding/choose-fields
  • ปัญหา: v4 GeocodeAddress ไม่มีตัวกรองคอมโพเนนต์แบบเข้มงวด (v3 components=country:US) พารามิเตอร์ address.* ที่มีโครงสร้างจะรวมเป็นที่อยู่เดียวและไม่กรองผลลัพธ์ นอกจากนี้ regionCode ยังไม่มีค่าเริ่มต้นใน v4 (v3 มีค่าเริ่มต้นเป็น us) วิธีแก้ไข: กรอง results ฝั่งไคลเอ็นต์: จับคู่ regionCode ที่เป็นตัวพิมพ์ใหญ่กับ postalAddress.regionCode จับคู่พื้นที่การดูแลระบบ 2 ตัวอักษรที่เป็นตัวพิมพ์ใหญ่กับ postalAddress.administrativeArea และ administrative_area_level_n addressComponents (shortText) ปรับทั้งอินพุตและ postalAddress.postalCode ให้เป็นมาตรฐาน (ตัดช่องว่าง/ขีดกลางและใช้กฎภูมิภาค) ดู /maps/documentation/geocoding/geocoding-v4-migrate
  • ปัญหา: การเรียกใช้ Geocoding API v4 โดยตรงจาก JavaScript ของเบราว์เซอร์จะเปิดเผยคีย์ API และสามารถข้ามข้อจำกัดเกี่ยวกับ URL ที่มาของ HTTP ได้โดยการปลอมแปลงส่วนหัว Referer วิธีแก้ไข: เรียกใช้ v4 จากแบ็กเอนด์ของคุณเองด้วยคีย์ที่มีการป้องกัน หรือใช้บริการการเข้ารหัสพิกัดภูมิศาสตร์ของ Maps JavaScript API (แบ็กเอนด์ v3) สำหรับความต้องการฝั่งไคลเอ็นต์ ดู /maps/documentation/geocoding/geocoding-v4-migrate
  • ปัญหา: SearchDestinations สามารถแสดงผลลัพธ์ที่ไม่มีที่อยู่หลักที่แน่นอนได้ ซึ่งแตกต่างจาก v3 และเมธอด v4 อื่นๆ วิธีแก้ไข: ตั้งค่า placeFilter.addressability เป็น PRIMARY เมื่อต้องการเฉพาะผลลัพธ์ที่มีที่อยู่หลักที่แน่นอน ดู /maps/documentation/geocoding/geocoding-v4-migrate
  • ปัญหา: โค้ดที่เขียนสำหรับ Geocoding API v3 ไม่ทำงานในการตอบกลับ REST ของ v4 เนื่องจาก v4 ใช้ชื่อฟิลด์ lowerCamelCase (addressComponents ไม่ใช่ address_components) นำ status และ error_message ออก และแสดงผลออบเจ็กต์รูทเดียวจาก GeocodePlace แทนอาร์เรย์ results วิธีแก้ไข: ตรวจสอบรหัสสถานะ HTTP และเนื้อหาข้อผิดพลาดในการเรียก REST v4, อ่านฟิลด์ lowerCamelCase (addressComponents, postalAddress) และโปรดทราบว่าการตอบกลับ gRPC ยังคงใช้ snake_case ดู /maps/documentation/geocoding/geocoding-v4-migrate

Geocoding API: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว

  • ข้อมูลเจาะจงเฉพาะพื้นที่ของ Geocoding API v3 (extra_computations: BUILDING_AND_ENTRANCES, NAVIGATION_POINTS, GROUNDS; ช่องการตอบกลับ buildings.entrances, navigation_points, buildings.building_outlines, grounds): เลิกใช้งานตั้งแต่วันที่ 13-08-2025 รายการทดแทน: เมธอด SearchDestinations (POST /v4/geocode/destinations) ของ Geocoding API v4 ดูคำแนะนำในการย้ายข้อมูล

สิ่งที่คุณทำได้ด้วย Geocoding API

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ