ย้ายข้อมูลจาก Directions API หรือ Distance Matrix API

คู่มือนี้จะอธิบายวิธีย้ายข้อมูลแอปที่ใช้ 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

เพิ่มการรองรับ TWO_WHEELER และ TRANSIT
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

ไม่รวมอยู่ในคำตอบ คุณต้องใส่คำสั่งต่อไปนี้เมื่อแสดงผลลัพธ์แก่ผู้ใช้

Powered by Google, ©YEAR Google

เช่น

Powered by Google, ©2022 Google
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