คู่มือนี้จะอธิบายวิธีย้ายข้อมูลแอปที่ใช้ 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 ที่จำกัดไว้ที่ 16384 อักขระ ฟีเจอร์นี้ไม่มีความจำเป็นใน Routes API เนื่องจากจุดอ้างอิงสามารถส่งได้ในเนื้อหาคำขอ REST หรือ gRPC เป็นพิกัดละติจูด/ลองจิจูด โปรดดูตัวอย่างจากหัวข้อตัวอย่าง HTTP ในเอกสารคํานวณเมทริกซ์เส้นทาง หรือกําหนดจุดแวะพักกลางทางในเอกสารระบุจุดแวะพักกลางทาง
แปลงพารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ใน Directions API และ Distance Matrix API ที่เปลี่ยนชื่อหรือแก้ไขแล้ว หรือพารามิเตอร์ที่ GA ไม่รองรับ อัปเดตโค้ดหากคุณใช้พารามิเตอร์เหล่านี้
ขอ Conversion ของพารามิเตอร์
พารามิเตอร์เส้นทางหรือเมทริกซ์ระยะทาง | พารามิเตอร์ Routes API | หมายเหตุ |
---|---|---|
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 เส้นทางขนส่งสาธารณะแต่ละส่วนในการเดินทางที่มีโหมดการเดินทางเดียวกัน (เช่น เดินหรือขนส่งสาธารณะ) จะถือว่ามี 1 ขั้นตอน และเส้นทางแต่ละเส้นทางสำหรับโหมดการเดินทางนั้นๆ จะอยู่ในขั้นตอนย่อย ในทางตรงกันข้าม ใน Routes API ขั้นตอนจะเป็นคำสั่งการนำทางคำสั่งเดียวที่สอดคล้องกันสำหรับการเดินทางทุกประเภท ดังนั้น วิธีการไปยังส่วนต่างๆ แต่ละรายการจึงเป็นขั้นตอน สำหรับหลายขั้นตอนในการเดินทางรูปแบบเดียว Routes API จะมีข้อมูลเมตาที่มีสรุปขั้นตอนสำหรับการเดินทางรูปแบบนั้นใน `stepsOverview` หากต้องการขอข้อมูลเมตานี้ ให้ใช้มาสก์ช่อง `routes.legs.stepsOverview` ดูข้อมูลเพิ่มเติม |
transit_routing_preference |
transitRoutingPreference |
ดูข้อมูลเพิ่มเติม |
units |
units |
ดูข้อมูลเพิ่มเติม |
waypoints |
intermediates |
ยกเลิกการรองรับเส้นประกอบที่เข้ารหัส |
optimize=true สำหรับจุดอ้างอิง |
"optimizeWaypointOrder": "true" |
ดูข้อมูลเพิ่มเติม |
Conversion พารามิเตอร์การตอบกลับ
พารามิเตอร์เส้นทางหรือเมทริกซ์ระยะทาง | พารามิเตอร์ Routes API | หมายเหตุ |
---|---|---|
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 |