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

คำแนะนำนี้จะอธิบายวิธีย้ายข้อมูลแอปที่ใช้ ขอเส้นทาง 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 โปรดดูตัวอย่างต่อไปนี้

แปลงจุดแวะพักที่เข้ารหัสด้วยเส้นประกอบเป็นจุดแวะพักของตำแหน่ง

การระบุจุดอ้างอิงเป็นโพลีไลน์ที่เข้ารหัสมีให้ใช้งานใน API เส้นทางเพื่อให้พอดีกับ จำนวนจุดอ้างอิงในขีดจำกัดของ URL คือ 16,384 อักขระ ฟีเจอร์นี้ไม่ใช่ ใน 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 รองรับเส้นทางการประมวลผลเท่านั้น
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 หมายเหตุ
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