ภาพรวม Geocoding API

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

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

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

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

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

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

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

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

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