Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ย้ายข้อมูลจาก 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 ที่ 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`	รองรับเฉพาะเส้นทาง Compute
`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 มีข้อมูลการตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์สำหรับจุดอ้างอิงที่ระบุเป็นที่อยู่เท่านั้น
`bounds`	`viewport`
`legs.end_address`	ไม่พร้อมใช้งาน	ใช้รหัสสถานที่แทนพิกัดเพื่อการกำหนดเส้นทางที่มีความแม่นยำสูง รหัสสถานที่ประกอบด้วยข้อมูลที่ปรับเส้นทางไปยังจุดเข้าถึงที่ถูกต้อง หากเริ่มต้นด้วยที่อยู่: ให้ใช้ Place Autocomplete หรือ Geocoding API เพื่อแปลงเป็นรหัสสถานที่ หากคุณเริ่มต้นด้วยพิกัด: ให้พิจารณาใช้ค้นหาสถานที่เพื่อระบุตำแหน่งที่มีความหมายมากขึ้น การรับที่อยู่จากพิกัดเพียงอย่างเดียวอาจซับซ้อนและทำให้เกิดการสแนปที่ไม่ถูกต้อง Routes API จะไม่เข้ารหัสพิกัดย้อนกลับเป็นที่อยู่
`legs.start_address`	ไม่พร้อมใช้งาน
`overview_polyline`	เส้นประกอบ
`summary`	`description`
`waypoint_order`	`optimizedIntermediateWaypointIndex`