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

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

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

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

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