ภาพรวมของ Routes API

Routes API เป็นบริการที่ยอมรับคำขอ HTTPS และส่งกลับเส้นทางที่เหมาะสมระหว่างสถานที่ 2 แห่ง หรือระยะทางและเวลาเดินทางเป็นเมทริกซ์ของเส้นทางระหว่างตำแหน่งต้นทางและจุดหมายที่ต่างกัน

เหตุผลที่ควรใช้ Routes API

เมื่อใช้ Routes API คุณจะได้รับข้อมูลเส้นทางและข้อมูลการเดินทางที่แม่นยำ โดยใช้รายละเอียดการขนส่ง ข้อมูลการจราจรและสภาพถนนล่าสุด และค่ากําหนดเส้นทาง ดังนี้

  • ประเภทและความสามารถของการเดินทางรูปแบบต่างๆ

  • ยานพาหนะที่กำลังมุ่งหน้าไป

  • บริเวณข้างถนนที่มีรถกระบะหรือรถไปส่ง

  • สภาพการจราจรและการปิดถนน

  • ข้อกังวลด้านความปลอดภัย เช่น การหลีกเลี่ยงพื้นที่อันตราย หรือการให้จุดรับส่งที่ปลอดภัย

  • สร้างสมดุลระหว่างเวลาในการตอบสนอง คุณภาพ และต้นทุนกับความต้องการใช้บริการเส้นทางด้วยฟีเจอร์เสริม เช่น ค่าผ่านทางและข้อมูลเมตาการเดินทาง เช่น เวลาและระยะทาง และการประหยัดเชื้อเพลิง

นอกจากนี้ คุณยังสามารถกำหนดเส้นทางที่มีประสิทธิภาพที่สุดสำหรับการกำหนดเวลาการส่งงาน เช่น

  • วิธีที่ดีที่สุดในการมอบหมายผู้ปฏิบัติงานให้ไปรับชุดแพ็กเกจ

  • กำหนดคลังสินค้าที่ดีที่สุดสำหรับการจัดส่งพัสดุไปยังปลายทางสุดท้าย

คุณใช้ Routes API ทำอะไรได้บ้าง

Routes API จะช่วยให้คุณได้รับข้อมูลการกำหนดเส้นทาง 2 หมวดหมู่หลักดังนี้

  • เส้นทางจากสถานที่หนึ่งไปยังจุดหมายเดียวหรือหลายแห่ง

  • เมทริกซ์ของเส้นทางที่เป็นไปได้ระหว่างตำแหน่งเริ่มต้นและตำแหน่งปลายทางหลายแห่ง

รับเส้นทางสำหรับจุดหมายเดียวหรือหลายแห่ง

เมื่อใช้เมธอด Routes API Compute Routes คุณจะคำนวณตำแหน่งต่างๆ ได้ดังนี้

  • ขอเส้นทางสำหรับการเดินทางด้วยวิธีต่างๆ และไปยังจุดหมายเดียวหรือหลายปลายทาง

    • รูปแบบการเดินทาง รวมถึงการขนส่ง การขับรถ ยานพาหนะสองล้อ การเดิน หรือขี่จักรยาน

    • ชุดจุดอ้างอิงที่คุณสามารถเพิ่มประสิทธิภาพเพื่อลำดับในการเดินทางไปที่แม่นยำที่สุด

  • วิธีการระบุต้นทาง ปลายทาง และจุดอ้างอิงมีหลายวิธี

    • สตริงข้อความ ตัวอย่างเช่น "ชิคาโก, อิลลินอยส์", "ดาร์วิน, นอร์ทแคโรไลนา, ออสเตรเลีย", "1800 Amphitheatre Parkway, Mountain View, CA 94043" หรือ "CWF6+FWX Mountain View, California"

    • รหัสสถานที่

    • พิกัดละติจูดและลองจิจูด (ไม่บังคับ)

  • ปรับแต่งตัวเลือกเส้นทางตามความต้องการและเป้าหมายของคุณ ดังนี้

  • ควบคุมเวลาในการตอบสนองและคุณภาพด้วยการขอเฉพาะข้อมูลที่ต้องการโดยใช้มาสก์ช่อง ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลที่ไม่จำเป็นและมีอัตราการเรียกเก็บเงินคำขอที่สูงขึ้น โปรดดูรายละเอียดที่เลือกข้อมูลที่จะแสดง

รับเมทริกซ์ของเส้นทางที่เป็นไปได้

เมธอด Routes API Compute Route Matrix จะระบุเมทริกซ์ของข้อมูลเส้นทางที่แนะนำระหว่างจุดเริ่มต้นและจุดสิ้นสุดหลายจุด รวมถึงระยะทางและเวลาถึงโดยประมาณ เพื่อช่วยให้คุณเลือกต้นทางและปลายทางที่ดีที่สุดตามความต้องการทางธุรกิจของคุณ คุณสามารถขอข้อมูลระยะทางประเภทต่อไปนี้ได้

  • ระยะทางสำหรับรูปแบบการเดินทางที่เลือก

  • ระยะทางเป็นกิโลเมตรหรือไมล์

  • ระยะเวลาเดินทางโดยประมาณในสภาพการจราจร

ข้อมูลระยะทางจะช่วยให้คุณเลือกวิธีที่มีประสิทธิภาพที่สุดในการกำหนดเส้นทางผู้โดยสาร การจัดส่ง หรือผู้ปฏิบัติงานระหว่างต้นทางและปลายทางที่เป็นไปได้

คุณสามารถสตรีมองค์ประกอบของการตอบสนองก่อนที่จะคำนวณเมทริกซ์ทั้งหมด เพื่อลดเวลาในการตอบสนองของการตอบสนอง

คุณจะระบุต้นทางและปลายทางได้หลายรายการต่อคำขอฝั่งเซิร์ฟเวอร์ โดยระบุจำนวนต้นทางคูณกับจำนวนปลายทางสูงสุด 625 รายการ

Routes API ทำงานอย่างไร

Routes API มี 2 วิธี ได้แก่ ComputeRoute และ ComputeRouteMatrix

ComputeRoute

เมธอด Routes API ComputeRoute จะยอมรับคำขอ HTTP POST ที่มีเนื้อหาของคำขอ JSON ที่มีรายละเอียดคำขอ ต้องระบุต้นทาง, ปลายทาง, travelMode และมาสก์ฟิลด์เพื่อระบุฟิลด์ที่จะแสดงผล

ตัวอย่าง

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

จากนั้นบริการจะคำนวณเส้นทางที่ขอ และแสดงผลช่องที่คุณขอ

ComputeRouteMatrix

Routes API ComputeRouteMatrix ยอมรับคำขอ HTTP POST ที่มีเนื้อหาของคำขอ JSON ที่มีรายละเอียดคำขอ ต้องระบุต้นทางอย่างน้อย 1 แห่ง, ปลายทางอย่างน้อย 2 แห่ง, travelMode และมาสก์ของช่องเพื่อระบุช่องที่จะแสดงผล

ตัวอย่าง

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

คำตอบจะแสดงเส้นทางที่เป็นไปได้สำหรับชุดค่าผสมของจุดอ้างอิงต้นทางและปลายทางทั้งหมด

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Routes API พร้อมด้วยข้อมูลที่แสดง

แหล่งข้อมูล ข้อมูลที่ส่งคืน รูปแบบการคืนสินค้า
ComputeRoute แสดงผลเส้นทาง ขา และขั้นตอนสำหรับเส้นทาง พร้อมด้วยเส้นทางอื่น หากมีการร้องขอ JSON
ComputeRouteMatrix แสดงผลอาร์เรย์ของเส้นทางจากจุดอ้างอิงต้นทางหนึ่งไปยังจุดอ้างอิงปลายทางหนึ่ง

วิธีใช้ Routes API

1 ตั้งค่าเลย เริ่มด้วยตั้งค่าโปรเจ็กต์ Google Cloud แล้วทำตามวิธีการตั้งค่าให้เสร็จสิ้น
2 คำนวณเส้นทางและตรวจสอบคำตอบ โปรดดูข้อมูลเพิ่มเติมที่รับเส้นทางและตรวจสอบการตอบกลับของเส้นทาง
3 คำนวณเมทริกซ์ของเส้นทางและตรวจสอบคำตอบ ดูข้อมูลเพิ่มเติมได้ที่รับเมทริกซ์เส้นทางและตรวจสอบการตอบสนองของเมทริกซ์เส้นทาง

ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน

ดูรายการไลบรารีของไคลเอ็นต์ที่พร้อมใช้งานสำหรับ Routes API ได้ที่ไลบรารีของไคลเอ็นต์

ขั้นตอนถัดไป