ภาพรวม Roads API

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

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

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

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

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

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

  • Snap to Roads บริการนี้จะแสดงถนนที่มีความเป็นไปได้มากที่สุด ซึ่งมีการเดินทางตามชุดพิกัด GPS ที่ระบุ คุณระบุจุด GPS ที่รวบรวมตามเส้นทางได้สูงสุด 100 จุด นอกจากนี้ คุณยังขอให้บริการประมาณค่าจุดเพิ่มเติมได้ด้วย ซึ่งจะทำให้เส้นทางเป็นไปตามรูปทรงเรขาคณิตของถนนอย่างราบรื่น
  • ถนนที่ใกล้ที่สุด บริการนี้จะแสดงส่วนถนนที่ใกล้ที่สุดสำหรับจุด 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 พร้อมกับข้อมูลที่ส่งคืน

แหล่งข้อมูล ข้อมูลที่แสดงผล รูปแบบการแสดงผล
ลากเส้นทางไปตามถนน

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

  • JSON
ถนนที่ใกล้ที่สุด

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

ขีดจำกัดความเร็ว

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

วิธีใช้ Roads API

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

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

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

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

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