ภาพรวม Roads API

Roads API เป็นบริการที่รับคำขอ HTTPS พร้อม พิกัดละติจูด/ลองจิจูดสำหรับจุดอย่างน้อย 1 จุดบนแผนที่ โดยจะใช้จุดเหล่านี้เพื่อค้นหาส่วนของถนนที่อยู่ใกล้เคียงและแสดงผลรหัสสถานที่พร้อมข้อมูลเมตา เช่น ส่วนของถนนที่ใกล้ที่สุดและการจำกัดความเร็ว

เหตุผลที่ควรใช้ Roads API

Roads API ช่วยให้คุณดูการจำกัดความเร็ว เวลาที่คาดว่าจะถึง หรือข้อมูลเมตาอื่นๆ ของถนนได้Roads API ข้อมูลเมตาของถนนนี้ช่วยให้คุณเพิ่มขีดความสามารถต่อไปนี้ลงในแอปการขับขี่ได้

  • เชื่อมโยงพิกัดละติจูด/ลองจิจูดกับถนนอย่างน้อย 1 เส้น
  • ค้นหาถนนที่ใกล้ที่สุดสำหรับชุดพิกัด
  • ดูการจำกัดความเร็วสำหรับส่วนของถนน

สิ่งที่คุณทำได้ด้วย Roads API

ด้วย Roads API คุณสามารถแมปพิกัด GPS กับ รูปทรงเรขาคณิตของถนน และกำหนดการจำกัดความเร็วตาม ส่วนของถนนได้

  • Snap to Roads บริการนี้จะแสดงผลถนนที่มีความเป็นไปได้มากที่สุด ที่เดินทางผ่านโดยอิงตามชุดพิกัด GPS ที่ระบุ คุณระบุจุด GPS ได้สูงสุด 100 จุดที่รวบรวมตามเส้นทาง นอกจากนี้ คุณยังขอให้บริการประมาณจุดเพิ่มเติมได้ด้วย ซึ่งจะทำให้เกิดเส้นทางที่ราบรื่นตามรูปทรงเรขาคณิตของถนน
  • Nearest Roads บริการนี้จะแสดงผลส่วนของถนนที่ใกล้ที่สุดสำหรับจุด GPS คุณระบุจุด GPS ได้สูงสุด 100 จุด โดยจุดที่คุณระบุไม่จำเป็นต้องเป็นส่วนหนึ่งของเส้นทางต่อเนื่อง
  • การจำกัดความเร็ว บริการนี้จะแสดงผลการจำกัดความเร็วที่ประกาศไว้ สำหรับส่วนของถนน บริการการจำกัดความเร็วพร้อมให้บริการแก่ลูกค้าทุกคนที่มีใบอนุญาตการติดตามเนื้อหา สำหรับลูกค้า Google Maps Platform Premium Plan ที่เปลี่ยนไปใช้ราคาแบบจ่ายตามการใช้งาน ฟีเจอร์นี้จะยังคงใช้งานได้

วิธีทำงานของ Roads API

Roads API ใช้ปลายทาง 3 รายการที่รับพิกัดละติจูด/ลองจิจูด หรือรหัสสถานที่เพื่อแสดงเส้นทาง ถนน หรือข้อมูลการจำกัดความเร็ว ตัวอย่างต่อไปนี้แสดงคำขอถนนที่ใกล้ที่สุดโดยอิงตามชุดพิกัดละติจูด/ลองจิจูด

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

แหล่งข้อมูล

ตารางต่อไปนี้สรุปแหล่งข้อมูลที่พร้อมใช้งานผ่าน Roads API พร้อมข้อมูลที่แสดงผล

แหล่งข้อมูล ข้อมูลที่แสดงผล รูปแบบการแสดงผล
Snap to Roads

แสดงผลอาร์เรย์ของจุด GPS สูงสุด 100 จุดจากเส้นทาง รวม พิกัดลองจิจูด/ละติจูดที่ลากเส้นทางไปตามถนนพร้อม รหัสสถานที่ ดูรายละเอียดได้ใน ส่วนการตอบกลับ ในคู่มือ Snap to Roads

  • JSON
Nearest Roads

อาร์เรย์ของพิกัดละติจูด/ลองจิจูดอิสระสูงสุด 100 รายการ พร้อมรหัสสถานที่สำหรับถนนที่ใกล้ที่สุดสำหรับแต่ละจุดที่ระบุ จุดไม่จำเป็นต้องต่อเนื่องกัน ดูรายละเอียดได้ใน ส่วนการตอบกลับ ในคู่มือ Nearest Roads

Speed limits

อาร์เรย์ขององค์ประกอบข้อมูลเมตาของถนนสูงสุด 100 รายการ ซึ่งประกอบด้วยการจำกัดความเร็ว และรหัสสถานที่ โดยมีหน่วยเป็น KPH หรือ MPH ดูรายละเอียดได้ในส่วนการตอบกลับในคู่มือSpeed limits

วิธีใช้ Roads API

1 ลองใช้เวอร์ชันเดโมของ Snap to Roads คลิกเวอร์ชันเดโมเพื่อสร้างแทร็กและดูว่าปลายทาง Snap to Roads แสดงข้อมูลได้อย่างราบรื่นเพียงใด ดู เวอร์ชันเดโม ในคู่มือ Snap to Roads คุณไม่จำเป็นต้องใช้คีย์ API
2 ตั้งค่า เริ่มต้นด้วย ตั้งค่า โปรเจ็กต์ Google Cloud และทำตามวิธีการตั้งค่าที่ตามมา จากนั้นดู วิธีใช้คีย์ API
3 ลองใช้คำขอ Snap to Roads ใช้ตัวอย่าง Snap to Roads ตัวอย่างใดตัวอย่างหนึ่ง และลองใช้ตัวอย่างที่เกี่ยวข้องกับ Use Case ของคุณ
4 ดูการจำกัดความเร็วสำหรับเส้นทางถนน ใช้ข้อมูลเส้นทางเดียวกันกับที่ระบุไว้สำหรับคำขอ Snap to Roads และ ส่งคำค้นหาการจำกัดความเร็ว ดูตัวอย่างคำขอโดยใช้เส้นทาง
5 ดูวิธีประมวลผลเส้นทางยาวๆ ทำตามส่วนเกี่ยวกับการประมวลผลเส้นทางยาวๆ ในคู่มือแนวคิดขั้นสูง
6 รวมข้อมูลถนนไว้ในแอปของคุณเอง ดูตัวอย่างโค้ดโดยละเอียดจากเวอร์ชันเดโมที่ลากเส้นทางไปตามถนนเพื่อเริ่มสร้างฟังก์ชันการทำงานของข้อมูลถนนลงในแอปของคุณเอง

ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน

เรียกใช้ API นี้ในภาษาที่ต้องการผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้

Java Client, Python Client, Go Client และ Node.js Client for Google Maps Services เป็นไลบรารีของไคลเอ็นต์ที่ชุมชนให้การสนับสนุน ซึ่งเป็นโอเพนซอร์สภายใต้ ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณจะดูวิธีการติดตั้งและตัวอย่างโค้ดได้ด้วย

ขั้นตอนถัดไป