ภาพรวม Roads API

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

เหตุผลที่ควรใช้ 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 ลองใช้คำขอจัดตำแหน่งให้ชิดถนน ใช้ตัวอย่างการปักหมุดตามถนน ข้อใดข้อหนึ่ง แล้วลองใช้ตัวอย่างที่เกี่ยวข้องกับ Use Case ของคุณ
4 ดูขีดจำกัดความเร็วของเส้นทาง ดำเนินการค้นหาขีดจำกัดความเร็วโดยใช้ข้อมูลเส้นทางเดียวกับที่คุณให้ไว้สำหรับคำขอผสานกับถนน ดูตัวอย่างคำขอโดยใช้เส้นทาง
5 ดูวิธีประมวลผลเส้นทางที่ยาว ทำตามส่วนการประมวลผลเส้นทางที่ยาว ในคู่มือแนวคิดขั้นสูง
6 รวมข้อมูลถนนไว้ในแอปของคุณเอง ดูตัวอย่างโค้ดโดยละเอียดจากเดโมภาพถนนเพื่อเริ่มสร้างฟังก์ชันการทำงานของข้อมูลถนนในแอปของคุณเอง

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

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

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

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