ย้ายข้อมูลจาก Directions API (เดิม) หรือ Distance Matrix API (เดิม)

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

คู่มือนี้อธิบายวิธีย้ายข้อมูลแอปที่ใช้ Directions API หรือ Distance Matrix API ไปใช้ Routes API ดูรายละเอียดเกี่ยวกับ Routes API ได้ที่ภาพรวมของผลิตภัณฑ์

แนวทางปฏิบัติแนะนำในการเรียกเก็บเงินสำหรับการย้ายข้อมูล

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

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

การระบุจุดแวะพักเป็น Polyline ที่เข้ารหัสพร้อมใช้งานใน 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
mode travelMode

เพิ่มการรองรับ TWO_WHEELER และ TRANSIT
region regionCode
traffic_model trafficModel ดูข้อมูลเพิ่มเติม
transit_mode "travelMode": "TRANSIT" ใน Directions API (เดิม) ในเส้นทางการขนส่งสาธารณะ แต่ละ ส่วนของการเดินทางที่มีโหมดการเดินทางเดียวกัน (เช่น เดินหรือ ขนส่งสาธารณะ) จะถือเป็น 1 ขั้นตอน และเส้นทางแต่ละเส้นทางสำหรับ โหมดการเดินทางนั้นจะอยู่ในขั้นตอนย่อย ในทางตรงกันข้าม ใน Routes API ขั้นตอนจะเป็นคำสั่งการนำทาง 1 รายการเสมอ สำหรับการเดินทางทุกประเภท ดังนั้นคำสั่งการนำทางแต่ละรายการจึงเป็น 1 ขั้นตอน สำหรับหลายขั้นตอนในโหมดการเดินทางเดียว 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 มีข้อมูลการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์สำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่เท่านั้น
bounds viewport
legs.end_address ไม่พร้อมใช้งาน
legs.start_address ไม่พร้อมใช้งาน
overview_polyline เส้นประกอบ
summary description
waypoint_order optimizedIntermediateWaypointIndex