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