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

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