ย้ายข้อมูลจาก 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

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

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

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

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 รองรับเส้นทางการประมวลผลเท่านั้น มีข้อมูลการตอบกลับที่ระบุพิกัดทางภูมิศาสตร์สำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่เท่านั้น
bounds viewport
legs.end_address ไม่พร้อมใช้งาน
legs.start_address ไม่พร้อมใช้งาน
overview_polyline เส้นประกอบ
summary description
waypoint_order optimizedIntermediateWaypointIndex