ภาพรวมของ Routes API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • สตริงข้อความ ตัวอย่างเช่น "ชิคาโก อิลลินอยส์" "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 ที่หัวข้อไลบรารีของไคลเอ็นต์

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