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

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

หากที่อยู่สำหรับการเรียกเก็บเงินของคุณอยู่ในเขตเศรษฐกิจยุโรป ตั้งแต่วันที่ 8 กรกฎาคม 2025 เป็นต้นไป ข้อกำหนดในการให้บริการของ Google Maps Platform ใน EEA จะมีผลบังคับใช้กับการใช้บริการของคุณ ฟังก์ชันการทำงานจะแตกต่างกันไปตามภูมิภาค ดูข้อมูลเพิ่มเติม

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

หมายเหตุ: หากคุณใช้ Routes API เวอร์ชันทดลอง โปรดดูข้อมูลเกี่ยวกับการย้ายข้อมูลไปยังเวอร์ชัน GA ได้ที่ ย้ายข้อมูลจากเวอร์ชันทดลองไปยังเวอร์ชัน GA

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

คำแนะนำนี้จะมีผลหากการใช้ 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 โปรดอัปเดตโค้ดหากคุณใช้พารามิเตอร์เหล่านี้

การแปลงพารามิเตอร์คำขอ

พารามิเตอร์ Directions หรือเมทริกซ์ระยะทาง	พารามิเตอร์ 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 ขั้นตอนต่างๆ จะเป็นคำแนะนำการนำทาง 1 รายการ ในโหมดการเดินทางทุกประเภท ดังนั้นคำแนะนำการนำทางแต่ละรายการจึงเป็น 1 ขั้นตอน สำหรับหลายขั้นตอนในโหมดการเดินทางเดียว Routes API จะให้ข้อมูลเมตาที่มีข้อมูลสรุปของขั้นตอนสำหรับโหมดการเดินทางนั้นๆ ใน `stepsOverview` หากต้องการขอข้อมูลเมตานี้ ให้ใช้ฟิลด์มาสก์ `routes.legs.stepsOverview` ดูข้อมูลเพิ่มเติม
transit_routing_preference	transitRoutingPreference	ดูข้อมูลเพิ่มเติม
units	units	ดูข้อมูลเพิ่มเติม
waypoints	intermediates	นำการรองรับเส้นประกอบที่เข้ารหัสออก
optimize=true สำหรับจุดอ้างอิง	"optimizeWaypointOrder": "true"	ดูข้อมูลเพิ่มเติม

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

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