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 | ลองส่งคำขอ Geocoding | เมื่อมีคีย์ API แล้ว คุณจะเริ่มทดสอบ Geocoding API ได้โดยตรงจาก curl หรือเบราว์เซอร์ คุณจะต้องระบุพารามิเตอร์การค้นหาที่ถูกต้อง สำหรับการค้นหาที่อยู่หรือคอมโพเนนต์ ดูรายละเอียดได้ที่ พารามิเตอร์การแปลงพิกัดภูมิศาสตร์ |
| 3 | ลองส่งคำขอการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | ระบุพิกัดละติจูด/ลองจิจูดพร้อมกับคีย์ API เพื่อรับ คอมโพเนนต์ที่อยู่สำหรับที่อยู่ที่อ่านได้ซึ่งอยู่ใกล้ที่สุดสำหรับตำแหน่งนั้น ดูรายละเอียดได้ที่คำขอ Geocoding แบบย้อนกลับ |
| 4 | ทำความเข้าใจพื้นฐานของการตอบกลับ | ปลายทางทั้งหมดใน Geocoding API จะแสดงข้อมูลเดียวกันในรูปแบบ JSON หรือ XML ดู การตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ เพื่อดูคำอธิบายข้อมูล รหัสสถานะ และข้อความแสดงข้อผิดพลาด |
| 5 | รวมข้อมูลการแปลงพิกัดภูมิศาสตร์ลงในแอปของคุณเอง | คุณสามารถใช้ข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์เพื่อรับที่อยู่จากเครื่องหมายบนแผนที่ หรือเพื่อจัดหาเครื่องหมายบนแผนที่ตามที่อยู่ที่ทราบ |
ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน
เรียกใช้ API นี้ในภาษาที่คุณเลือกผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้
- Java Client สำหรับบริการของ 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
- เริ่มต้นใช้งานด้วยคำขอและการตอบกลับตัวอย่าง: ไปที่ คำขอและการตอบกลับการแปลงพิกัดภูมิศาสตร์
- ทำตามแนวทางปฏิบัติแนะนำ: ไปที่แนวทางปฏิบัติแนะนำในการแปลงที่อยู่เป็นพิกัดภูมิศาสตร์