ภาพรวมของ Routes API

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

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

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

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

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

  • ด้านข้างของถนนสำหรับจุดรับหรือส่งคืน

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

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

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

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

  • วิธีที่ดีที่สุดในการกำหนดกลุ่มผู้ปฏิบัติงานให้มารับชุดพัสดุ

  • เลือกคลังสินค้าที่ดีที่สุดในการจัดส่งพัสดุไปยังคลังสินค้าสุดท้าย ปลายทาง

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

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

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

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

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

เมธอด Routes API Compute Routes ซึ่งใช้คำนวณระหว่างสถานที่ตั้งต่างๆ ดังนี้

  • ขอเส้นทางสําหรับวิธีต่างๆ ในการเดินทาง และสําหรับเส้นทางเดียวหรือหลายเส้นทาง ปลายทาง:

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

    • ชุดจุดอ้างอิงที่คุณสามารถเพิ่มประสิทธิภาพเพื่อ นำเด็กๆ เข้ามา

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

    • สตริงข้อความ เช่น "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" หรือ "CWF6+FWX Mountain View, California"

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

    • พิกัดละติจูดและลองจิจูด (ไม่บังคับ) พร้อมส่วนหัวของรถ

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

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

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

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

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

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

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

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

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

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

วิธีการทำงานของ Routes API

Routes API มี 2 เมธอด ได้แก่ ComputeRoutes และ ComputeRouteMatrix

ComputeRoutes

เมธอด Routes API ComputeRoutes จะยอมรับคำขอ 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 และข้อมูลที่ส่งกลับมา

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

วิธีใช้ Routes API

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

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

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

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