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