Geocoding API เป็นบริการที่ยอมรับสถานที่ในรูปแบบที่อยู่ พิกัดละติจูดและลองจิจูด หรือรหัสสถานที่ โดยจะแปลงที่อยู่เป็นพิกัดละติจูดและลองจิจูดและรหัสสถานที่ หรือแปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ให้เป็นที่อยู่
สิ่งที่คุณทำได้ด้วย Geocoding API
คุณสามารถใช้ Geocoding API เพื่อรับข้อมูลการเข้ารหัสพิกัดภูมิศาสตร์สำหรับที่อยู่หรือสถานที่อย่างน้อย 1 แห่ง ซึ่งรวมถึงข้อมูลต่อไปนี้
Geocoding API v4 รุ่นนี้ประกอบด้วยการเปิดตัวปลายทางต่อไปนี้
- เข้ารหัสพิกัดภูมิศาสตร์ของที่อยู่ - พิกัดทางภูมิศาสตร์ของที่อยู่ เรียกอีกอย่างว่าการเข้ารหัสพิกัดภูมิศาสตร์แบบส่งต่อ
- เข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ตั้ง - ที่อยู่สำหรับชุดพิกัดละติจูดและลองจิจูด หรือที่เรียกว่าการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ
- การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ - ดึงข้อมูลที่อยู่จากรหัสสถานที่
- ค้นหาจุดหมาย - ค้นหาจุดหมายจากที่อยู่ รหัสสถานที่ หรือสถานที่ตั้ง
คุณควบคุมตำแหน่งที่ผลการค้นหาจะปรากฏและจำกัดผลการค้นหาให้อยู่ในภูมิภาค เขต หรือรหัสไปรษณีย์ที่เฉพาะเจาะจงได้
ลองใช้
วิธีการทำงานของ Geocoding API
Geocoding API ทำทั้งการเข้ารหัสพิกัดภูมิศาสตร์และการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ ดังนี้
- การเข้ารหัสพิกัดภูมิศาสตร์: แปลงที่อยู่ เช่น "1600 Amphitheatre Parkway, Mountain View, CA" เป็นพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ คุณสามารถใช้พิกัดเหล่านี้เพื่อวางเครื่องหมายบนแผนที่ หรือเพื่อจัดกึ่งกลางหรือเปลี่ยนตำแหน่งแผนที่ภายในเฟรมมุมมอง
- การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ: แปลงพิกัดละติจูดและลองจิจูดหรือรหัสสถานที่ให้เป็นที่อยู่ที่มนุษย์อ่านได้ คุณสามารถใช้ที่อยู่สำหรับสถานการณ์ต่างๆ ได้ เช่น การนำส่งหรือการรับสินค้า
ตารางต่อไปนี้สรุปแหล่งข้อมูลที่พร้อมใช้งานผ่าน Geocoding API พร้อมกับข้อมูลที่แต่ละเมธอดแสดงผล
| แหล่งข้อมูล | ข้อมูลที่แสดงผล | รูปแบบการแสดงผล |
|---|---|---|
| การเข้ารหัสพิกัดภูมิศาสตร์ | แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูเอกสารประกอบเกี่ยวกับการตอบกลับรหัสพิกัดภูมิศาสตร์ |
|
| การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูเอกสารประกอบเกี่ยวกับการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ | |
| การเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ | แสดงผลที่อยู่ คอมโพเนนต์ที่อยู่ และประเภทที่อยู่ ดูเอกสารประกอบเกี่ยวกับการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ | |
| การค้นหาปลายทาง | แสดงข้อมูลโดยละเอียดเกี่ยวกับจุดหมายต่างๆ ตามเกณฑ์อินพุตที่แตกต่างกัน เช่น ที่อยู่ รหัสสถานที่ หรือพิกัดละติจูดและลองจิจูด ดูเอกสารประกอบเกี่ยวกับการค้นหาปลายทาง |
เปิดตัวช่องสเตจ
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 จากเซิร์ฟเวอร์แบ็กเอนด์ของคุณเอง ดูรายละเอียดเพิ่มเติมเกี่ยวกับรูปแบบการติดตั้งใช้งานที่ปลอดภัยและทางเลือกสำหรับความต้องการฝั่งไคลเอ็นต์ได้ที่ข้อควรพิจารณาด้านความปลอดภัย