คู่มือนี้อธิบายวิธีย้ายข้อมูลแอปที่ใช้ 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
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 ที่ 16,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 |
รองรับเส้นทางการประมวลผลเท่านั้น |
mode |
travelMode |
เพิ่มการรองรับ |
region |
regionCode |
|
traffic_model |
trafficModel |
ดูข้อมูลเพิ่มเติม |
transit_mode |
"travelMode": "TRANSIT" |
ใน Directions API ในเส้นทางการขนส่งสาธารณะ แต่ละส่วนของการเดินทางที่มีรูปแบบการเดินทางเดียวกัน (เช่น เดินหรือขนส่งสาธารณะ) จะถือว่าเป็น 1 ขั้นตอน และแต่ละเส้นทางสำหรับรูปแบบการเดินทางนั้นจะอยู่ในขั้นตอนย่อย ในทางตรงกันข้าม ใน 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 |
รองรับเส้นทางการประมวลผลเท่านั้น มีข้อมูลการตอบกลับที่ระบุพิกัดทางภูมิศาสตร์สำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่เท่านั้น |
bounds |
viewport |
|
legs.end_address |
ไม่พร้อมใช้งาน | |
legs.start_address |
ไม่พร้อมใช้งาน | |
overview_polyline |
เส้นประกอบ | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |