หน้านี้ได้รับการแปลโดย Cloud Translation API

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