ย้ายข้อมูลจาก Directions API หรือ Distance Matrix API

คู่มือนี้จะอธิบายวิธีย้ายข้อมูลแอปที่ใช้ 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 ที่จำกัดไว้ที่ 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 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" ดูข้อมูลเพิ่มเติม

การแปลงพารามิเตอร์การตอบกลับ

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