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 พร้อมด้วยข้อมูลที่แต่ละปลายทางแสดงผล
แหล่งข้อมูล | ข้อมูลที่ส่งคืน | รูปแบบการคืนสินค้า |
---|---|---|
การระบุพิกัดทางภูมิศาสตร์ | แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ ดูผลลัพธ์ในคู่มือคำขอและการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ |
|
การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ โปรดดูการตอบกลับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับในคู่มือคำขอและการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | |
วางพิกัดภูมิศาสตร์ | แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ โปรดดูการตอบกลับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับในคู่มือคำขอและการตอบกลับการระบุพิกัดทางภูมิศาสตร์ |
วิธีใช้ Geocoding API
1 | เตรียมตัวให้พร้อม | เริ่มด้วยการตั้งค่าโปรเจ็กต์ Google Cloud และทำตามวิธีการตั้งค่าด้านล่างให้เสร็จสมบูรณ์ |
2 | ลองใช้คำขอเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์ | เมื่อมีคีย์ API แล้ว คุณสามารถเริ่มทดสอบ Geocoding API ได้โดยตรงจาก cURL หรือเบราว์เซอร์ คุณจะต้องระบุพารามิเตอร์การค้นหาที่ถูกต้องสำหรับการค้นหาที่อยู่หรือคอมโพเนนต์ ดูรายละเอียดได้ที่พารามิเตอร์การระบุพิกัดทางภูมิศาสตร์ |
3 | ลองใช้คำขอเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ | ระบุพิกัดละติจูด/ลองจิจูดพร้อมกับคีย์ API เพื่อรับคอมโพเนนต์ที่อยู่สำหรับที่อยู่ที่มนุษย์อ่านได้ใกล้ที่สุดสำหรับสถานที่นั้น ดูรายละเอียดได้ที่คำขอเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์แบบย้อนกลับ |
4 | ทำความเข้าใจพื้นฐานคำตอบ | ปลายทางทั้งหมดใน Geocoding API จะแสดงข้อมูลเดียวกันใน JSON หรือ XML ดูคำตอบเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์สำหรับคำอธิบายเกี่ยวกับข้อมูล รหัสสถานะ และข้อความแสดงข้อผิดพลาด |
5 | ผสานรวมข้อมูลการระบุพิกัดทางภูมิศาสตร์ลงในแอปของคุณเลย! | คุณสามารถใช้ข้อมูลการระบุพิกัดทางภูมิศาสตร์เพื่อรับที่อยู่จากเครื่องหมายบนแผนที่ หรือเพื่อระบุเครื่องหมายบนแผนที่ตามที่อยู่ที่รู้จัก |
ไลบรารีของไคลเอ็นต์ที่ใช้ได้
เรียกใช้ API นี้ในภาษาที่คุณต้องการผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้
- ไคลเอ็นต์ Java สำหรับบริการ Google Maps
- ไคลเอ็นต์ Python สำหรับบริการ Google Maps
- ไคลเอ็นต์ Go สำหรับบริการ Google Maps
- ไคลเอ็นต์ Node.js สำหรับบริการ Google Maps
ไคลเอ็นต์ Java, Python Client, Go Client และ Node.js สำหรับบริการ Google Maps เป็นไลบรารีของไคลเอ็นต์ที่รองรับชุมชน และเป็นโอเพนซอร์สภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณยังสามารถดูวิธีการติดตั้งและโค้ดตัวอย่างได้อีกด้วย
ขั้นตอนถัดไป
- เริ่มใช้ Geocoding API: ไปที่ตั้งค่าโปรเจ็กต์ Google Cloud
- เริ่มต้นใช้งานคำขอและการตอบกลับตัวอย่างโดยไปที่คำขอและคำตอบเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์
- ทำตามแนวทางปฏิบัติแนะนำ: ไปที่แนวทางปฏิบัติแนะนำเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์