ย้ายข้อมูลจาก 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 ที่จำกัดไว้ที่ 16384 อักขระ ฟีเจอร์นี้ไม่จําเป็นใน Routes API เนื่องจากสามารถส่งจุดแวะพักในเนื้อหาคําขอ REST หรือ gRPC เป็นพิกัดละติจูด/ลองจิจูด โปรดดูตัวอย่างจากหัวข้อตัวอย่าง HTTP ในเอกสารคํานวณเมทริกซ์เส้นทาง หรือกําหนดจุดแวะพักกลางทางในเอกสารระบุจุดแวะพักกลางทาง

แปลงพารามิเตอร์

ตารางต่อไปนี้แสดงพารามิเตอร์ใน Directions API และ Distance Matrix API ที่เปลี่ยนชื่อหรือแก้ไขแล้ว หรือพารามิเตอร์ที่ GA ไม่รองรับ อัปเดตโค้ดหากคุณใช้พารามิเตอร์เหล่านี้

การแปลงพารามิเตอร์คําขอ

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

การแปลงพารามิเตอร์การตอบกลับ

พารามิเตอร์เส้นทางหรือเมทริกซ์ระยะทาง พารามิเตอร์ 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