ภาพรวม Geocoding API

Geocoding API เป็นบริการที่ยอมรับสถานที่เป็นที่อยู่ พิกัดละติจูดและลองจิจูด หรือรหัสสถานที่ โดยจะแปลงที่อยู่เป็นพิกัดละติจูดและลองจิจูดและรหัสสถานที่ หรือแปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่เป็นที่อยู่

เหตุผลที่ควรใช้ Geocoding API

ใช้ Geocoding API สำหรับเว็บไซต์หรือแอปพลิเคชันบนอุปกรณ์เคลื่อนที่เมื่อคุณต้องการใช้ข้อมูลการระบุพิกัดทางภูมิศาสตร์ภายในแผนที่ซึ่งให้บริการโดย Google Maps Platform API เมื่อใช้ Geocoding API คุณจะใช้ที่อยู่เพื่อวางเครื่องหมายบนแผนที่ หรือแปลงเครื่องหมายบนแผนที่เป็นที่อยู่ได้ บริการนี้ออกแบบมาสำหรับการระบุพิกัดทางภูมิศาสตร์ที่อยู่แบบคงที่และคงที่สำหรับตำแหน่งของเนื้อหาแอปพลิเคชันบนแผนที่

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

คุณสามารถใช้ Geocoding API เพื่อรับข้อมูลพิกัดภูมิศาสตร์ของที่อยู่หรือสถานที่ อย่างน้อย 1 แห่ง รวมทั้งข้อมูลต่อไปนี้:

  • พิกัดทางภูมิศาสตร์สำหรับที่อยู่
  • ที่อยู่สำหรับชุดพิกัดละติจูดและลองจิจูด
  • ที่อยู่สำหรับรหัสสถานที่

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

Geocoding API ทำงานอย่างไร

Geocoding API จะดำเนินการทั้งการระบุพิกัดทางภูมิศาสตร์และการทำ Geocoding API ดังนี้

  • การระบุพิกัดทางภูมิศาสตร์: แปลงที่อยู่ เช่น "1600 Amphitheatre Parkway, Mountain View, CA" เป็นพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ คุณสามารถใช้พิกัดเหล่านี้เพื่อวางเครื่องหมายบนแผนที่ หรือเพื่อจัดตำแหน่งแผนที่ให้อยู่ตรงกลางหรือเปลี่ยนตำแหน่งภายในเฟรมมุมมองได้
  • การระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ: แปลงพิกัดละติจูด/ลองจิจูดหรือรหัสสถานที่เป็นที่อยู่ที่มนุษย์อ่านได้ คุณใช้ที่อยู่ได้ในสถานการณ์ต่างๆ เช่น การจัดส่งหรือไปรับ

การสาธิตต่อไปนี้ใช้บริการ Geocoding ผ่าน Maps JavaScript API เพื่อสาธิตวิธีการทำงานของ Geocoding API เปิดแผนที่ในแท็บแยกต่างหากเพื่อดูตัวเลือกและรายละเอียดเพิ่มเติม

แหล่งข้อมูล

ตารางต่อไปนี้จะสรุปทรัพยากรที่มีผ่าน Geocoding API พร้อมด้วยข้อมูลที่แต่ละปลายทางแสดงผล

แหล่งข้อมูล ข้อมูลที่ส่งคืน รูปแบบการคืนสินค้า
การระบุพิกัดทางภูมิศาสตร์ แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ ดูผลลัพธ์ในคู่มือคำขอและการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์
  • JSON
  • XML
การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ โปรดดูการตอบกลับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับในคู่มือคำขอและการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ
วางพิกัดภูมิศาสตร์ แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ โปรดดูการตอบกลับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับในคู่มือคำขอและการตอบกลับการระบุพิกัดทางภูมิศาสตร์

วิธีใช้ Geocoding API

1 เตรียมตัวให้พร้อม เริ่มด้วยการตั้งค่าโปรเจ็กต์ Google Cloud และทำตามวิธีการตั้งค่าด้านล่างให้เสร็จสมบูรณ์
2 ลองใช้คำขอเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์ เมื่อมีคีย์ API แล้ว คุณสามารถเริ่มทดสอบ Geocoding API ได้โดยตรงจาก cURL หรือเบราว์เซอร์ คุณจะต้องระบุพารามิเตอร์การค้นหาที่ถูกต้องสำหรับการค้นหาที่อยู่หรือคอมโพเนนต์ ดูรายละเอียดได้ที่พารามิเตอร์การระบุพิกัดทางภูมิศาสตร์
3 ลองใช้คำขอเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ ระบุพิกัดละติจูด/ลองจิจูดพร้อมกับคีย์ API เพื่อรับคอมโพเนนต์ที่อยู่สำหรับที่อยู่ที่มนุษย์อ่านได้ใกล้ที่สุดสำหรับสถานที่นั้น ดูรายละเอียดได้ที่คำขอเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ
4 ทำความเข้าใจพื้นฐานคำตอบ ปลายทางทั้งหมดใน Geocoding API จะแสดงข้อมูลเดียวกันใน JSON หรือ XML ดูคำตอบเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์สำหรับคำอธิบายเกี่ยวกับข้อมูล รหัสสถานะ และข้อความแสดงข้อผิดพลาด
5 ผสานรวมข้อมูลการระบุพิกัดทางภูมิศาสตร์ลงในแอปของคุณเลย! คุณสามารถใช้ข้อมูลการระบุพิกัดทางภูมิศาสตร์เพื่อรับที่อยู่จากเครื่องหมายบนแผนที่ หรือเพื่อระบุเครื่องหมายบนแผนที่ตามที่อยู่ที่รู้จัก

ไลบรารีของไคลเอ็นต์ที่ใช้ได้

เรียกใช้ API นี้ในภาษาที่คุณต้องการผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้

ไคลเอ็นต์ Java, Python Client, Go Client และ Node.js สำหรับบริการ Google Maps เป็นไลบรารีของไคลเอ็นต์ที่รองรับชุมชน และเป็นโอเพนซอร์สภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณยังสามารถดูวิธีการติดตั้งและโค้ดตัวอย่างได้อีกด้วย

ขั้นตอนถัดไป