ภาพรวม Roads API

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

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

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

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

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

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

  • สแนปไปยังถนน บริการนี้ให้การแสดงผลที่เป็นไปได้มากที่สุด ถนนที่เดินทางตามชุดพิกัด GPS ที่ให้ไว้ คุณสามารถระบุได้สูงสุด 100 จุด GPS ที่รวบรวมตามเส้นทาง นอกจากนี้ คุณยังขอให้บริการ สอดประสานประเด็นเพิ่มเติมต่างๆ เข้าด้วยกัน ส่งผลให้เกิดเป็นเส้นทางที่ลื่นไหลไปตาม เรขาคณิตของถนน
  • ถนนที่ใกล้ที่สุด บริการนี้จะแสดงถนนที่ใกล้ที่สุด ของจุด 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 Client, Python Client, Go Client และ Node.js สำหรับ Google Maps บริการต่างๆ เป็นไลบรารีไคลเอ็นต์ที่สนับสนุนโดยชุมชน โดยเป็นโอเพนซอร์สภายใต้ ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณยังสามารถดูวิธีการติดตั้งและโค้ดตัวอย่างได้อีกด้วย

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