Geocoding API เป็นบริการที่รับสถานที่เป็นที่อยู่ พิกัดละติจูดและลองจิจูด หรือรหัสสถานที่ โดยจะแปลงที่อยู่เป็นพิกัดละติจูดและลองจิจูด รวมถึงรหัสสถานที่ หรือแปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่เป็นที่อยู่
สิ่งที่คุณทำได้ด้วย Geocoding API
คุณสามารถใช้ Geocoding API เพื่อรับข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์สำหรับที่อยู่หรือสถานที่อย่างน้อย 1 แห่ง ซึ่งรวมถึงข้อมูลต่อไปนี้
Geocoding API v4 เวอร์ชันนี้มีการเปิดตัวปลายทางต่อไปนี้
- การเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ — พิกัดทางภูมิศาสตร์สำหรับที่อยู่ เรียกอีกอย่างว่า การเข้ารหัสพิกัดภูมิศาสตร์แบบไปข้างหน้า
- การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ — ที่อยู่สำหรับชุดพิกัดละติจูดและลองจิจูด เรียกอีกอย่างว่า การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ
- การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ — ดึงที่อยู่จากรหัสสถานที่
- ค้นหาสถานที่ - ค้นหาสถานที่จากที่อยู่ รหัสสถานที่ หรือสถานที่
คุณสามารถควบคุมตำแหน่งที่จะให้ผลการค้นหาปรากฏและจำกัดผลการค้นหาให้อยู่ในภูมิภาค เขต หรือรหัสไปรษณีย์ที่เฉพาะเจาะจงได้
ลองใช้
วิธีการทำงานของ Geocoding API
Geocoding API ทำทั้งการเข้ารหัสพิกัดภูมิศาสตร์และ การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ
- การเข้ารหัสพิกัดภูมิศาสตร์: แปลงที่อยู่ เช่น "1600 Amphitheatre Parkway, Mountain View, CA" เป็นพิกัดละติจูดและ ลองจิจูดหรือรหัสสถานที่ คุณสามารถใช้พิกัดเหล่านี้เพื่อวางมาร์กเกอร์บนแผนที่ หรือเพื่อจัดกึ่งกลางหรือเปลี่ยนตำแหน่งแผนที่ภายในเฟรมมุมมอง
- การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ: แปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่เป็น ที่อยู่ที่มนุษย์อ่านได้ คุณสามารถใช้ที่อยู่สำหรับสถานการณ์ต่างๆ รวมถึงการจัดส่งหรือการรับสินค้า
ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Geocoding API พร้อมกับข้อมูลที่แต่ละเมธอดแสดงผล
| ทรัพยากรข้อมูล | ข้อมูลที่แสดงผล | รูปแบบการแสดงผล |
|---|---|---|
| การเข้ารหัสพิกัดภูมิศาสตร์แบบไปข้างหน้า | แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ ดูเอกสารประกอบเกี่ยวกับคำตอบที่เป็นรหัสพิกัดภูมิศาสตร์ Geocode response |
|
| การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ ดูเอกสารประกอบเกี่ยวกับคำตอบที่เป็นการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | |
| การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ | แสดงผลที่อยู่ องค์ประกอบของที่อยู่ และประเภทที่อยู่ ดูเอกสารประกอบเกี่ยวกับคำตอบที่เป็นรหัสพิกัดภูมิศาสตร์ของสถานที่ | |
| การค้นหาสถานที่ | แสดงผลข้อมูลโดยละเอียดเกี่ยวกับสถานที่ต่างๆ ตามเกณฑ์การป้อนข้อมูลที่แตกต่างกัน เช่น ที่อยู่ รหัสสถานที่ หรือพิกัดละติจูดและลองจิจูด ดูเอกสารประกอบเกี่ยวกับการค้นหาสถานที่ Destination search |
ช่องเวอร์ชันการเปิดตัว
Geocoding API เวอร์ชัน 4 มีช่องแยกกันสำหรับฟีเจอร์ GA, Preview และ Experimental หากต้องการใช้ฟีเจอร์ Preview หรือ Experimental โปรดระบุช่องที่ถูกต้องในคำขอ ตัวอย่างเช่น หากต้องการเข้าถึงฟีเจอร์ของปลายทาง Destinations ในเวอร์ชันทดลอง ให้ใช้คำขอ HTTP นี้ https://geocode.googleapis.com/v4alpha/geocode/destinations
| เวอร์ชันการเปิดตัว | ชื่อช่อง |
|---|---|
| GA | /v4/ |
| Preview | /v4beta/ |
| Experimental | /v4alpha/ |
- ดูข้อมูลอ้างอิง REST เพื่อดู รายการและคำอธิบายของทรัพยากร REST ทั้งหมดที่พร้อมใช้งาน
- ดูข้อมูลเพิ่มเติมเกี่ยวกับแต่ละ เวอร์ชันได้ที่เวอร์ชันการเปิดตัว
ฟีเจอร์ใน Geocoding API v4
Geocoding API เวอร์ชัน 4 มีฟีเจอร์ใหม่ๆ ดังนี้
เมธอดการค้นหาสถานที่
v4 ขอแนะนำเมธอดการค้นหาสถานที่ ที่ช่วยให้คุณ ดึงข้อมูลโดยละเอียดเกี่ยวกับสถานที่ต่างๆ ตามเกณฑ์อินพุตที่แตกต่างกัน เช่น แอดเดรส รหัสสถานที่ หรือพิกัดละติจูดและลองจิจูด คำตอบประกอบด้วยข้อมูลสรุปที่ทำงานด้วยระบบ AI และโทเค็นจุดนำทาง ที่มีข้อมูลตามบริบทซึ่งส่งไปยัง Navigation SDK เพื่อการกำหนดเส้นทางที่แม่นยำได้
ใช้งานบนแพลตฟอร์มมาตรฐานของ Google Cloud
Geocoding API v4 ใช้งานบนโครงสร้างพื้นฐาน ของบริการ ใน Google Cloud การใช้งานนี้มาพร้อมกับแพลตฟอร์มที่ปลอดภัยและเชื่อถือได้มากขึ้น พร้อมตัวเลือกการรักษาความปลอดภัยที่ดียิ่งขึ้น เช่น OAuth การออกแบบ API มาตรฐานนี้ช่วยให้ API มีความสอดคล้องกันในระดับหนึ่ง ซึ่งช่วยเพิ่มประสิทธิภาพในการพัฒนาด้วย Geocoding API v4
เพิ่มการรองรับ OAuth แล้ว
Geocoding API v4 รองรับการใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์ Google รองรับสถานการณ์ทั่วไปของ OAuth 2.0 เช่น สำหรับเว็บเซิร์ฟเวอร์
เพิ่มการรองรับฟิลด์มาสก์แล้ว
ใช้ฟิลด์มาสก์เพื่อระบุข้อมูลที่คำตอบควรแสดงผล สำหรับเมธอดการเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ และการเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ ระบบจะแสดงผลทุกฟิลด์ในออบเจ็กต์คำตอบโดยค่าเริ่มต้น สำหรับเมธอดการค้นหาสถานที่ คุณต้องระบุฟิลด์มาสก์ในคำขอ API
ความปลอดภัยของ API
Geocoding API v4 ได้รับการออกแบบให้เป็น API แบบเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์ การเรียกจากฝั่งไคลเอ็นต์โดยตรงจากเบราว์เซอร์จะทำให้คีย์ API มีความเสี่ยงสูงที่จะถูกขโมยและนำไปใช้ในทางที่ผิด เนื่องจากข้อจำกัดของ HTTP Referrer ไม่เพียงพอที่จะปกป้องปลายทางของเว็บเซอร์วิส
เราขอแนะนำอย่างยิ่งให้คุณเรียก Geocoding API v4 จากเซิร์ฟเวอร์แบ็กเอนด์ของคุณเอง ดูรายละเอียดเพิ่มเติมเกี่ยวกับรูปแบบการใช้งานที่ปลอดภัยและทางเลือกสำหรับ ความต้องการของฝั่งไคลเอ็นต์ได้ที่ข้อควรพิจารณาด้านความปลอดภัย