Roads API ภาพรวม

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

เหตุใดจึงควรใช้ Roads API

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

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

Roads API ช่วยให้คุณทําอะไรได้บ้าง

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

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

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 จุดจากเส้นทาง รวมถึงพิกัดลองจิจูด/ละติจูดที่สแนปพร้อมรหัสสถานที่ ดูรายละเอียดในคําตอบในคู่มือสแนปไปยังถนน

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

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

การจํากัดความเร็ว

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

วิธีใช้ Roads API

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

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

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

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

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