ย้ายข้อมูลจาก 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 ไม่รองรับ อัปเดตโค้ดหากคุณใช้พารามิเตอร์เหล่านี้

ขอ Conversion ของพารามิเตอร์

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

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