ภาพรวมของ Routes API

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

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

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

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

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

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

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

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

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

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

  • วิธีที่ดีที่สุดในการกำหนดกลุ่มคนงานให้ไปรับพัสดุชุดหนึ่ง

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

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

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

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

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

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

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

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

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

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

  • วิธีต่างๆ ในการกำหนดจุดเริ่มต้น จุดหมาย และจุดแวะพัก

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

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

    • พิกัดละติจูดและลองจิจูด พร้อมทิศทางของยานพาหนะ (ไม่บังคับ)

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

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

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

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

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

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

  • เวลาเดินทางโดยประมาณเมื่อเกิดรถติด

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

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

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

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

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

ComputeRoutes

เมธอด ComputeRoutes ของ Routes API จะยอมรับคําขอ 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 แสดงผลอาร์เรย์ของเส้นทางจากจุดเริ่มต้น 1 จุดไปยังจุดหมาย 1 จุด

วิธีใช้ Routes API

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

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

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

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