คู่มือนี้จะอธิบายวิธีย้ายข้อมูลแอปที่ใช้ Directions API หรือ Distance Matrix API เพื่อเปลี่ยนไปใช้ Routes API ดูรายละเอียดเกี่ยวกับ Routes API ได้ที่ภาพรวมผลิตภัณฑ์
อัปเดตปลายทาง REST API
อัปเดตโค้ดเพื่อใช้ปลายทาง Routes API ใหม่
จาก Directions API
Directions API | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
จาก Distance Matrix API
Distance Matrix API | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
Routes API | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
แปลงพารามิเตอร์ของ URL เพื่อใช้เนื้อหาของคำขอ HTTPS
เมื่อใช้ Directions API และ Distance Matrix API คุณจะส่งพร็อพเพอร์ตี้การกำหนดค่าเป็นพารามิเตอร์ของ URL ไปยังคำขอ HTTP GET
ได้ ตัวอย่างเช่น สำหรับ Directions API
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
เมื่อใช้ Routes API คุณจะส่งพารามิเตอร์ในเนื้อหาคำขอหรือในส่วนหัวซึ่งเป็นส่วนหนึ่งของคำขอ HTTP POST
โปรดดูตัวอย่างต่อไปนี้
แปลงจุดอ้างอิงที่เข้ารหัสแบบโพลีไลน์เป็นจุดอ้างอิงตำแหน่ง
คุณสามารถระบุจุดอ้างอิงเป็นโพลีไลน์ที่เข้ารหัสได้ใน Directions API เพื่อให้พอดีกับจุดอ้างอิงจำนวนมากที่จำนวนอักขระสูงสุดของ URL คือ 1,6,384 ตัว ไม่จำเป็นต้องใช้ฟีเจอร์นี้ใน Routes API เนื่องจากคุณสามารถส่งจุดอ้างอิงในเนื้อหาคำขอ REST หรือ gRPC เป็นพิกัดละติจูด/ลองจิจูดได้ โปรดดูตัวอย่างตัวอย่าง HTTP ในเอกสารคำนวณเมทริกซ์เส้นทาง หรือกำหนดจุดระหว่างทางในเอกสารระบุจุดระหว่างทาง
แปลงพารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ใน Directions API และ Distance Matrix API ที่มีการเปลี่ยนชื่อหรือแก้ไข หรือพารามิเตอร์ที่ไม่รองรับในรุ่น GA อัปเดตโค้ดของคุณหากคุณใช้พารามิเตอร์ใดๆ เหล่านี้
ขอ Conversion ของพารามิเตอร์
เส้นทางหรือพารามิเตอร์เมทริกซ์ระยะทาง | พารามิเตอร์ Routes API | Notes |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
ใช้ได้เฉพาะในโหมด TRANSIT เท่านั้น ไม่ใช่พร้อมกับ departureTime |
avoid |
routeModifiers |
|
departure_time |
departureTime |
ไม่สามารถใช้พร้อมกับ arrivalTime ได้ |
language |
languageCode |
รองรับสำหรับ Compute Routes เท่านั้น |
mode |
travelMode |
เพิ่มการรองรับ |
region |
regionCode |
|
traffic_model |
trafficModel |
ดูข้อมูลเพิ่มเติม |
transit_mode |
"travelMode": "TRANSIT" |
ใน Directions API เส้นทางขนส่งสาธารณะ ส่วนของการเดินทางที่มีรูปแบบการเดินทางเดียวกัน (เช่น เดินหรือขนส่งสาธารณะ) จะถือเป็นขั้นตอนเดียว และแต่ละเส้นทางสำหรับรูปแบบการเดินทางนั้นจะอยู่ในขั้นตอนย่อย ในทางตรงกันข้าม ใน Routes API ขั้นตอนจะเป็นคำสั่งการนำทางแบบเดียวตลอดการเดินทางทุกประเภท วิธีการไปยังส่วนต่างๆ แต่ละวิธีจึงเป็นขั้นตอนหนึ่ง Routes API จะแสดงข้อมูลเมตาที่มีสรุปขั้นตอนของรูปแบบการเดินทางนั้นใน "stepsOverview" หากต้องการขอข้อมูลเมตานี้ ให้ใช้มาสก์ช่อง "routes.legs.stepsOverview" เพื่อขอข้อมูลเมตานี้ ดูข้อมูลเพิ่มเติม |
transit_routing_preference |
transitRoutingPreference |
ดูข้อมูลเพิ่มเติม |
units |
ไม่สามารถใช้งานกับเมทริกซ์เส้นทาง | |
waypoints |
intermediates |
ยกเลิกการสนับสนุนโพลีไลน์ที่เข้ารหัสแล้ว |
optimize=true สำหรับจุดอ้างอิง |
"optimizeWaypointOrder": "true" |
ดูข้อมูลเพิ่มเติม |
Conversion ของพารามิเตอร์การตอบกลับ
เส้นทางหรือพารามิเตอร์เมทริกซ์ระยะทาง | พารามิเตอร์ Routes API | Notes |
---|---|---|
copyrights |
ไม่รวมอยู่ในคำตอบ คุณต้องใส่คำสั่งต่อไปนี้เมื่อแสดงผลลัพธ์แก่ผู้ใช้
เช่น
|
|
distance |
distanceMeters |
ข้อมูลระยะทางมีหน่วยเป็นเมตรเท่านั้น |
duration_in_traffic |
duration |
นําออกใน Routes API แล้ว ให้ใช้ duration |
status |
ไม่พร้อมใช้งาน ใช้รหัสตอบกลับ HTTP สำหรับข้อผิดพลาดที่รายงานโดย API ดูข้อมูลเพิ่มเติมได้ที่จัดการข้อผิดพลาดของคำขอ | |
geocoded_waypoints |
geocoding_results |
รองรับสำหรับ Compute Routes เท่านั้น มีข้อมูลการตอบกลับที่ระบุพิกัดทางภูมิศาสตร์เฉพาะสำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่เท่านั้น |
bounds |
viewport |
|
legs.end_address |
ไม่พร้อมใช้งาน | |
legs.start_address |
ไม่พร้อมใช้งาน | |
overview_polyline |
เส้นประกอบ | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |