Geocoding API เป็นบริการที่ยอมรับสถานที่ในรูปแบบที่อยู่ พิกัดละติจูดและลองจิจูด หรือรหัสสถานที่ โดยจะแปลงที่อยู่เป็นพิกัดละติจูดและลองจิจูดและรหัสสถานที่ หรือแปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ให้เป็นที่อยู่
Geocoding API v4 มีทั้งข้อมูลอัจฉริยะเกี่ยวกับจุดหมายและจุดที่มาถึงแบบเจาะจงเฉพาะพื้นที่ และการแปลงพิกัดเป็นที่อยู่หลัก ไม่ว่าคุณจะสร้างประสบการณ์การนำส่งสินค้าถึงมือผู้รับ การแชร์การเดินทาง หรือการนำทางแบบเลี้ยวต่อเลี้ยว หรือการปรับที่อยู่ให้เป็นพิกัด v4 ก็มีปลายทางเฉพาะที่ปรับให้เหมาะกับ Use Case ของคุณ
หากไม่แน่ใจว่าปลายทางใดเหมาะกับแอปพลิเคชันของคุณ ดูเลือกวิธีการเข้ารหัสพิกัดภูมิศาสตร์
สิ่งที่คุณทำได้ด้วย Geocoding API
Geocoding API v4 มีความสามารถและปลายทางต่อไปนี้
- ค้นหาจุดหมาย: ดึงข้อมูลรายละเอียดการมาถึงที่เจาะจงเฉพาะพื้นที่สำหรับจุดหมายจากที่อยู่ รหัสสถานที่ หรือพิกัด ซึ่งรวมถึงทางเข้าอาคาร โทเค็นจุดนำทางที่กำหนดเส้นทางได้ โครงร่างอาคารและพื้นที่ จุดหมายย่อย และจุดสังเกตใกล้เคียง
- เข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่: แปลงที่อยู่เป็นพิกัดทางภูมิศาสตร์และรหัสสถานที่ (การเข้ารหัสพิกัดภูมิศาสตร์แบบส่งต่อ)
- เข้ารหัสพิกัดภูมิศาสตร์ของสถานที่: แปลงพิกัดละติจูดและลองจิจูดเป็นที่อยู่หรือเขตบริหารที่มนุษย์อ่านได้ (การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ)
- เข้ารหัสพิกัดภูมิศาสตร์ของสถานที่: ดึงข้อมูลรายละเอียดที่อยู่และพิกัดที่จัดรูปแบบแล้วสำหรับรหัสสถานที่ที่รู้จักใน Google Maps
คุณควบคุมตำแหน่งที่ผลการค้นหาจะปรากฏและจำกัดผลการค้นหาให้อยู่ในภูมิภาค เขต หรือรหัสไปรษณีย์ที่เฉพาะเจาะจงได้
ลองใช้
วิธีการทำงานของ Geocoding API
Geocoding API v4 รองรับการค้นหาปลายทางควบคู่ไปกับการเข้ารหัสพิกัดภูมิศาสตร์พื้นฐาน ดังนี้
- การค้นหาปลายทาง (
SearchDestinations): แปลงที่อยู่ รหัสสถานที่ หรือคู่พิกัดเป็นออบเจ็กต์Destinationที่สมบูรณ์ ใช้วิธีนี้เมื่อการมาถึงสถานที่จริงเป็นสิ่งสำคัญ เช่น การระบุทางเข้าอาคารที่ต้องการ การกำหนดเส้นทางให้คนขับไปยังจุดรับหรือจุดส่งที่กำหนดโดยใช้โทเค็นจุดนำทาง การแสดงภาพอาคารบนแผนที่ หรือการนำทางในอาคารที่ซับซ้อนหลายอาคาร - การเข้ารหัสพิกัดภูมิศาสตร์พื้นฐาน: แปลงระหว่างที่อยู่ พิกัด และรหัสสถานที่
- การเข้ารหัสพิกัดภูมิศาสตร์: แปลงที่อยู่ เช่น "1600 Amphitheatre Parkway, Mountain View, CA" เป็นพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่เพื่อวางเครื่องหมายบนแผนที่หรือจัดเฟรมมุมมองแผนที่ให้อยู่ตรงกลาง
- การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ: แปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ให้เป็นที่อยู่ซึ่งมนุษย์อ่านได้สำหรับหมุดแผนที่ที่ผู้ใช้วาง ตัวเลือกสถานที่ หรือการแสดงผล UI
- การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่: ดึงรายละเอียดที่อยู่และพิกัดสำหรับรหัสสถานที่ที่รู้จักใน Google Maps
ตารางต่อไปนี้สรุปแหล่งข้อมูลที่พร้อมใช้งานผ่าน Geocoding API v4 พร้อมกับข้อมูลที่แต่ละเมธอดแสดงผล
| แหล่งข้อมูล | ข้อมูลที่แสดงผล | รูปแบบการแสดงผล |
|---|---|---|
| ค้นหาปลายทาง ( POST /v4/geocode/destinations)
|
แสดงข้อมูลอัจฉริยะเกี่ยวกับการมาถึงแบบเจาะจงเฉพาะพื้นที่: รูปหลายเหลี่ยมของอาคารและพื้นที่ (displayPolygon) entrancesทางกายภาพ navigationPointsที่กำหนดเส้นทางได้ (พร้อมโทเค็น) containingPlaces และ subDestinationsแบบลำดับชั้น landmarksเชิงสัมพันธ์ และรายละเอียดสถานที่หลัก ดูค้นหาจุดหมาย
|
|
| เข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ ( GET /v4/geocode/address)
|
แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูคำตอบที่เป็นรหัสพิกัดภูมิศาสตร์ | |
| เข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ตั้ง ( GET /v4/geocode/location)
|
แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | |
| เข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ ( GET /v4/geocode/places)
|
แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ |
เปิดตัวช่องสเตจ
Geocoding API เวอร์ชัน 4 มีช่องทางแยกต่างหากสำหรับฟีเจอร์ GA, เวอร์ชันตัวอย่าง และเวอร์ชันทดลอง หากต้องการใช้ฟีเจอร์เวอร์ชันตัวอย่างหรือเวอร์ชันทดลอง โปรดระบุแชแนลที่ถูกต้องในคำขอ ตัวอย่างเช่น หากต้องการเข้าถึงฟีเจอร์ของปลายทาง Destinations ในเวอร์ชันทดลอง ให้ใช้คำขอ HTTP นี้ https://geocode.googleapis.com/v4alpha/geocode/destinations
| ขั้นการเปิดตัว | ชื่อช่อง |
|---|---|
| เสีย | /v4/ |
| Preview | /v4beta/ |
| ทดลอง | /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 ทั่วไป เช่น สถานการณ์สำหรับเว็บเซิร์ฟเวอร์
เพิ่มการรองรับมาสก์ฟิลด์แล้ว
ใช้มาสก์ฟิลด์เพื่อระบุข้อมูลที่การตอบกลับควรแสดงผล สำหรับเมธอดเข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ เข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ตั้ง และการเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ ระบบจะแสดงผลฟิลด์ทั้งหมดในออบเจ็กต์การตอบกลับโดยค่าเริ่มต้น สำหรับเมธอด Search for destinations คุณต้องระบุฟิลด์มาสก์ในคำขอ API
ความปลอดภัยของ API
Geocoding API v4 ออกแบบมาเป็น API แบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ การเรียกฝั่งไคลเอ็นต์โดยตรงจากเบราว์เซอร์ทำให้คีย์ API มีความเสี่ยงสูงต่อการถูกขโมยและการใช้ในทางที่ผิด เนื่องจากการจำกัดผู้อ้างอิง HTTP ไม่เพียงพอที่จะปกป้องปลายทางของบริการบนเว็บ
เราขอแนะนำอย่างยิ่งให้เรียกใช้ Geocoding API v4 จากเซิร์ฟเวอร์แบ็กเอนด์ของคุณเอง ดูรายละเอียดเพิ่มเติมเกี่ยวกับรูปแบบการติดตั้งใช้งานที่ปลอดภัยและทางเลือกสำหรับความต้องการฝั่งไคลเอ็นต์ได้ที่ข้อควรพิจารณาด้านความปลอดภัย