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
- เริ่มต้นใช้งานคำขอและการตอบกลับตัวอย่าง: ไปที่ คำขอและการตอบกลับการแปลงพิกัดภูมิศาสตร์
- ทำตามแนวทางปฏิบัติแนะนำ: ไปที่แนวทางปฏิบัติแนะนำในการแปลงที่อยู่เป็นพิกัดภูมิศาสตร์