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 โปรดดูตัวอย่างต่อไปนี้

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

การระบุจุดอ้างอิงเป็นเส้นประกอบที่เข้ารหัสมีให้บริการใน 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 Routes เท่านั้น
`mode`	`travelMode`	ส่งในเนื้อหาคำขอ JSON ของ HTTP `POST` `computeRoutes` หรือ `computeRouteMatrix` โดยใช้ค่า `RouteTravelMode` (`DRIVE`, `TWO_WHEELER`, `WALK`, `TRANSIT`, `TRUCK` หรือ `BICYCLE` สำหรับ `computeRoutes`) แทนพารามิเตอร์การค้นหา URL `GET` เพิ่มการรองรับ `TWO_WHEELER`, `TRANSIT` และ `TRUCK`
`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`	ไม่พร้อมใช้งาน	ใช้รหัสสถานที่แทนพิกัดเพื่อการกำหนดเส้นทางที่มีความแม่นยำสูง รหัสสถานที่มีข้อมูลที่ช่วยให้เส้นทางไปยังจุดเข้าถึงที่ถูกต้อง หากเริ่มต้นด้วยที่อยู่: ให้ใช้ Place Autocomplete หรือ Geocoding API เพื่อแปลงเป็นรหัสสถานที่ หากเริ่มต้นด้วยพิกัด: ลองใช้ค้นหาจุดหมายเพื่อระบุสถานที่ที่มีความหมายมากขึ้น การรับที่อยู่จากพิกัดเพียงอย่างเดียวอาจมีความซับซ้อนและทำให้การสแนปไม่ถูกต้อง Routes API ไม่ได้แปลงพิกัดเป็นที่อยู่โดยใช้การเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ
`legs.start_address`	ไม่พร้อมใช้งาน
`overview_polyline`	เส้นประกอบ
`summary`	`description`
`waypoint_order`	`optimizedIntermediateWaypointIndex`