Routes API เป็นเว็บเซอร์วิสที่มี 2 เมธอด ได้แก่ Compute Routes ซึ่งจะแสดงผลเส้นทางระหว่างสถานที่ 2 แห่งพร้อมจุดอ้างอิงกลาง (ไม่บังคับ) และ Compute Route Matrix ซึ่งจะแสดงผลระยะทางและเวลาในการเดินทางสำหรับชุดค่าผสมของต้นทางและปลายทาง (สูงสุด 625 องค์ประกอบเมทริกซ์เส้นทาง)
Routes API: ข้อเท็จจริงสำคัญ
- ผลิตภัณฑ์: Routes API
- หรือที่เรียกว่า Routes API v2, Compute Routes, Compute Route Matrix
- หมวดหมู่: เส้นทาง
- แพลตฟอร์ม: บริการผ่านเว็บ (REST)
- ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
- ระยะการเปิดตัว: GA
- วงจร: ใช้งานอยู่
- ภาพรวม: ภาพรวมของ Routes API
- ภูมิภาคที่พร้อมให้บริการ: ทั่วโลก การกำหนดเส้นทางสำหรับรถ 2 ล้อ เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม และการคำนวณค่าผ่านทางจะจำกัดเฉพาะประเทศและเมืองที่รองรับ และไม่รองรับเขตแดนที่ขึ้นกับประเทศอื่นซึ่งมีรหัส CLDR ของตนเอง เว้นแต่จะระบุไว้ สำหรับที่อยู่สำหรับการเรียกเก็บเงินในเขตเศรษฐกิจยุโรป (EEA) ข้อกำหนดของ EEA ที่ https://developers.google.com/maps/comms/eea/routes ห้ามใช้คำอธิบายหรือขั้นตอนของเส้นทางกับแผนที่ใดๆ (รายละเอียดความครอบคลุม)
Routes API: กรณีที่ควรใช้
ใช้ Routes API ในกรณีต่อไปนี้
- คุณต้องมีเส้นทางระหว่างต้นทางและปลายทาง โดยมีจุดอ้างอิงกลาง (ไม่บังคับ) สำหรับการขับรถ การเดิน การปั่นจักรยาน การขับขี่รถ 2 ล้อ หรือการขนส่งสาธารณะ
- คุณต้องการระยะทางและเวลาเดินทางสำหรับคู่ต้นทาง-ปลายทางหลายคู่ในคำขอเดียว (สูงสุด 625 องค์ประกอบ)
- คุณต้องการค่าผ่านทางโดยประมาณ (บางเมือง) เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม (บางภูมิภาค) เส้นประกอบที่คำนึงถึงการจราจร หรือการกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่ (ความพร้อมให้บริการแบบจำกัด)
- คุณกำลังย้ายข้อมูลแอปเซิร์ฟเวอร์ออกจาก Directions API หรือ Distance Matrix API เดิม
อย่าใช้ Routes API ในกรณีต่อไปนี้
- คุณต้องเพิ่มประสิทธิภาพการมอบหมายการบรรทุกและหยุดการสั่งซื้อสำหรับยานพาหนะทั้งกลุ่ม โปรดใช้ Route Optimization API แทน
- คุณต้องมีการนำทางแบบเลี้ยวต่อเลี้ยวในแอปบน Android ที่เป็นไปตามเส้นทางที่คำนวณไว้ โปรดใช้ Navigation SDK สำหรับ Android แทน
- คุณต้องการการนำทางแบบเลี้ยวต่อเลี้ยวในแอปบน iOS ที่เป็นไปตามเส้นทางที่คำนวณไว้ โปรดใช้ Navigation SDK สำหรับ iOS แทน
Routes API: การตั้งค่า
- บริการที่ต้องเปิดใช้:
routes.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API, OAuth 2.0, บัญชีบริการ
- เริ่มต้นใช้งาน: ตั้งค่า Routes API
- ข้อมูลอ้างอิง: เอกสารอ้างอิง Routes API
- ราคา: การใช้งานและการเรียกเก็บเงินของ Routes API
- นโยบาย: นโยบาย Routes API
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Routes API
แพ็กเกจ Routes API อย่างเป็นทางการ
- npm:
@googlemaps/routing - pypi:
google-maps-routing - ไปที่:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
Routes API: ผลิตภัณฑ์ที่เกี่ยวข้อง
- แทนที่: Directions API, Distance Matrix API
- มักใช้ร่วมกับ: Navigation SDK สำหรับ Android, Navigation SDK สำหรับ iOS, Route Optimization API, Geocoding API, Places API (ใหม่)
Routes API: ข้อผิดพลาดที่พบบ่อย
- ปัญหา: ไม่มีรายการเริ่มต้นของช่องที่แสดงผล คำขอที่ไม่มีมาสก์ช่อง (ส่วนหัว
X-Goog-FieldMaskหรือพารามิเตอร์$fields) จะแสดงผลเป็นข้อผิดพลาด วิธีแก้ไข: ส่งมาสก์ฟิลด์ที่แสดงช่องการตอบกลับที่ต้องการเสมอ ดู /maps/documentation/routes/choose_fields - ปัญหา: การใช้มาสก์ฟิลด์ไวลด์การ์ด (
*) ในเวอร์ชันที่ใช้งานจริงจะเพิ่มค่าใช้จ่ายและเวลาในการตอบสนอง และค่าใช้จ่ายอาจเพิ่มขึ้นโดยไม่คาดคิดเมื่อมีการเพิ่มฟีเจอร์ขั้นสูงใหม่ๆ ลงในการตอบกลับ วิธีแก้ไข: ใช้*ระหว่างการพัฒนาเท่านั้น ในเวอร์ชันที่ใช้งานจริง ให้ขอเฉพาะฟิลด์ที่ต้องการ ดู /maps/documentation/routes/choose_fields - ปัญหา: ระบบจะไม่แสดงข้อมูลค่าผ่านทางและปริมาณการใช้เชื้อเพลิงเพียงแค่เพิ่มข้อมูลดังกล่าวลงในมาสก์ฟิลด์ เนื่องจากต้องเปิดใช้อย่างชัดเจนตั้งแต่ GA วิธีแก้ไข: เพิ่มอาร์เรย์
extraComputations(เช่นTOLLS,FUEL_CONSUMPTION) ลงในคำขอนอกเหนือจากฟิลด์มาสก์ ดู /maps/documentation/routes/migrate-routes-preview - ปัญหา: Compute Route Matrix อนุญาตให้มีองค์ประกอบได้ 625 รายการ แต่มีได้เพียง 100 รายการเมื่อ
routingPreferenceเป็นTRAFFIC_AWARE_OPTIMALวิธีแก้ไข: กำหนดให้ต้นทาง x ปลายทางมีจำนวนไม่เกิน 100 เมื่อใช้TRAFFIC_AWARE_OPTIMALหรือแบ่งคำขอออกเป็นหลายรายการ ดู /maps/documentation/routes/compute_route_matrix
สิ่งที่คุณทำได้ด้วย Routes API
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- แสดงเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 พิกัดเป็นชุดพิกัดสำหรับแต่ละขั้นตอนตามเส้นทาง
- แสดงเส้นทางระหว่างพิกัดละติจูด/ลองจิจูด 2 ชุดขึ้นไปเป็นชุดคำอธิบายการบังคับทิศทางสำหรับขั้นตอนต่างๆ ตามเส้นทาง
- แสดงระยะทางระหว่างแต่ละขั้นตอนตามเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 ชุด
- แสดงระยะเวลาเดินทางระหว่างแต่ละขั้นตอนตามเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 ชุด
- แสดงผลเส้นประกอบที่เข้ารหัสระหว่างแต่ละขั้นตอนตามเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 ชุด
- แสดงระยะทางของเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 ชุด
- แสดงระยะเวลาเดินทางสำหรับเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 ชุด
- แสดงผลเส้นประกอบที่เข้ารหัสสำหรับเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 ชุด
- แสดงข้อมูลค่าผ่านทางสำหรับเส้นทางระหว่างพิกัดละติจูด/ลองจิจูดอย่างน้อย 2 ชุด
- ระบุโหมดการเดินทาง (ขับรถ ขนส่งสาธารณะ เดิน มอเตอร์ไซค์) สำหรับคำขอเส้นทาง หมายเหตุ: ในบริการเว็บ Routes API (computeRoutes) ให้ส่ง travelMode ในเนื้อหา JSON ของ HTTP POST โดยใช้ RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT หรือ TRUCK ที่มี routeModifiers.vehicleInfo) และใส่ส่วนหัว X-Goog-FieldMask ที่จำเป็นแทนพารามิเตอร์การค้นหาโหมด GET เดิม ในไลบรารี Routes ของ Maps JavaScript API ให้ส่ง travelMode และฟิลด์ใน ComputeRoutesRequest
- ระบุจุดแวะพักหรือจุดผ่านสำหรับคำขอเส้นทาง
- ระบุวิธีใช้ข้อมูลการจราจรในคำขอเส้นทาง
- ระบุลักษณะที่ต้องการหลีกเลี่ยง เช่น ทางหลวงหรือค่าผ่านทาง สำหรับคำขอเส้นทาง
- กำหนดจุดอ้างอิงตามเส้นทาง
- กำหนดจุดอ้างอิงระหว่างทางตามเส้นทาง
- กำหนดจุดให้เส้นทางผ่าน
- ระบุทิศทางของยานพาหนะและฝั่งถนนสำหรับเส้นทาง
- เพิ่มประสิทธิภาพลำดับจุดแวะพักในเส้นทาง
- ระบุเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมสำหรับคำขอเส้นทาง ตัวอย่าง
- ระบุระยะทางที่สั้นลงหรือการกำหนดเส้นทางอื่นสำหรับคำขอเส้นทาง หมายเหตุ: ใน Routes API การขอเส้นทางอ้างอิงที่มีระยะทางสั้นกว่า (SHORTER_DISTANCE) อยู่ในขั้นทดลอง ส่วนการขอเส้นทางอื่น (computeAlternativeRoutes) อยู่ในขั้น GA
- แสดงระยะทางสำหรับเมทริกซ์ของเส้นทางระหว่างต้นทางและปลายทางหลายแห่ง
- แสดงระยะเวลาเดินทางสำหรับเมทริกซ์ของเส้นทางระหว่างต้นทางและปลายทางหลายแห่ง
- แสดงข้อมูลค่าผ่านทางสำหรับเมทริกซ์ของเส้นทางระหว่างต้นทางและปลายทางหลายแห่ง
- ระบุโหมดการเดินทาง (ขับรถ ขนส่งสาธารณะ เดิน สองล้อ) สำหรับคำขอเมทริกซ์เส้นทาง หมายเหตุ: ในเว็บเซอร์วิส Routes API (computeRouteMatrix) ให้ส่ง travelMode ในเนื้อหา HTTP POST JSON โดยใช้ RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT หรือ TRUCK ที่มี origins[].routeModifiers.vehicleInfo; เมทริกซ์เส้นทางไม่รองรับ BICYCLE) และรวมส่วนหัว X-Goog-FieldMask ที่จำเป็น ในไลบรารี Routes ของ Maps JavaScript API ให้ส่ง travelMode และฟิลด์ใน ComputeRouteMatrixRequest