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