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