เหตุใดจึงควรใช้ 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 จุดจากเส้นทาง รวมถึงพิกัดลองจิจูด/ละติจูดที่สแนปพร้อมรหัสสถานที่ ดูรายละเอียดในคําตอบในคู่มือสแนปไปยังถนน |
|
ถนนที่ใกล้ที่สุด |
อาร์เรย์ของพิกัดละติจูด/ลองจิจูดอิสระสูงสุด 100 รายการ พร้อมกับรหัสสถานที่สําหรับถนนที่ใกล้ที่สุดสําหรับแต่ละจุดที่ระบุ ไม่จําเป็นต้องให้คะแนนอย่างต่อเนื่อง ดูรายละเอียดในคําตอบในคู่มือถนนที่ใกล้ที่สุด |
|
การจํากัดความเร็ว |
อาร์เรย์ขององค์ประกอบข้อมูลเมตาของถนนสูงสุด 100 รายการ รายการเหล่านี้มีขีดจํากัดความเร็วและรหัสสถานที่ โดยมีหน่วยเป็น KPH หรือ MPH ดูรายละเอียดในคําตอบในคู่มือการจํากัดความเร็ว |
วิธีใช้ Roads API
1 | ลองการสาธิตการสแนปไปยังถนน | คลิกที่การสาธิตเพื่อสร้างแทร็ก แล้วดูว่าปลายทางของการสแนปไปยังถนนช่วยให้ข้อมูลราบรื่นได้อย่างไร ดู การสาธิต ในคู่มือจัดพอดีกับถนน โดยไม่จําเป็นต้องใช้คีย์ API |
2 | ตั้งค่า | เริ่มต้นด้วยการตั้งค่า โปรเจ็กต์ Google Cloud และทําตามวิธีการติดตั้งให้เสร็จสมบูรณ์ จากนั้นเรียนรู้วิธีใช้คีย์ API |
3 | ลองส่งคําขอบนถนนอย่างรวดเร็ว | ใช้ตัวอย่างหนึ่งในการสแนปไปยังถนน แล้วลองใช้ตัวอย่างที่เกี่ยวข้องกับกรณีการใช้งานของคุณ |
4 | รับขีดจํากัดความเร็วสําหรับเส้นทาง | ใช้ข้อมูลเส้นทางเดียวกันกับที่คุณระบุสําหรับคําขอสแนปไปยังถนน ส่งคําขอการค้นหาขีดจํากัดความเร็ว ดูตัวอย่างคําขอโดยใช้เส้นทาง |
5 | ดูวิธีประมวลผลเส้นทางที่ยาว | ดูหัวข้อเกี่ยวกับการประมวลผลเส้นทางแบบยาว ในคู่มือแนวคิดขั้นสูง |
6 | รวมข้อมูลถนนไว้ในแอปของคุณเอง | ดูตัวอย่างโค้ดโดยละเอียดจากการสาธิตการสแนปถนนเพื่อเริ่มสร้างฟังก์ชันข้อมูลถนนลงในแอปของคุณเอง |
ไลบรารีของไคลเอ็นต์ที่ใช้ได้
เรียก API นี้ในภาษาที่คุณต้องการผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้
- Java Client สําหรับบริการ Google Maps
- ไคลเอ็นต์ Python สําหรับบริการ Google Maps
- ให้ลูกค้าไปที่บริการ Google Maps
- ไคลเอ็นต์ Node.js สําหรับบริการ Google Maps
ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, Go Client และ Node.js สําหรับ Google Maps คือไลบรารีไคลเอ็นต์ที่ได้รับการสนับสนุนจากชุมชน ซึ่งเปิดให้ใช้ภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณสามารถอ่านคําแนะนําในการติดตั้งและโค้ดตัวอย่าง
ขั้นตอนถัดไป
- ลองใช้ Roads API: ไปที่ Roads Inspector
- ดูวิธีส่งคําขอ Roads API: ไปที่บริการที่คุณสนใจ
- ทําความเข้าใจแนวคิดขั้นสูง: ไปที่แนวคิดขั้นสูง
- ทําตามแนวทางปฏิบัติแนะนํา: ไปที่แนวทางปฏิบัติแนะนําสําหรับบริการเว็บ