กําหนดจุดผ่าน

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

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

เส้นทางที่มีจุดแวะพักต้นทาง จุดแวะพักกลางทาง และจุดแวะพักปลายทางจะมีขาเส้นทางเพียงขาเดียวที่เชื่อมต่อต้นทางและปลายทาง โดยผ่านจุดแวะพักกลางทาง (เรียกว่า via)

กำหนดค่าจุดอ้างอิงกลางให้เป็นจุดอ้างอิงแบบส่งผ่านโดย ตั้งค่าพร็อพเพอร์ตี้ via ของจุดอ้างอิงเป็น true โดยใช้ Waypoint (REST) หรือ Waypoint (gRPC)

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

ตัวอย่างต่อไปนี้แสดงวิธีทําเครื่องหมายจุดแวะพักกลางเป็นจุดแวะพักแบบส่งผ่าน

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

เข้าถึงรหัสสถานที่สำหรับจุดแวะพักกลางทาง

หากคุณระบุตำแหน่งของต้นทาง ปลายทาง หรือจุดแวะพักกลางทาง เป็นสตริงที่อยู่หรือเป็นโค้ด Plus API จะพยายามค้นหา ตำแหน่งที่เกี่ยวข้องมากที่สุดซึ่งมีรหัสสถานที่ที่สอดคล้องกัน อาร์เรย์ geocodingResults.intermediates ในผลลัพธ์มีรหัสสถานที่ที่ตรงกับตำแหน่งของ จุดอ้างอิง พร้อมด้วยข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่ง

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

เช่น

  • คุณระบุจุดแวะพักกลาง 3 จุดในคำขอ โดยจุดอ้างอิง 2 จุดระบุด้วยสตริงที่อยู่ และอีก 1 จุดระบุด้วยพิกัดละติจูด/ลองจิจูด

  • คุณใส่ geocodingResults ในฟิลด์มาสก์การตอบกลับเพื่อระบุให้แสดงอาร์เรย์ geocodingResults ในผลลัพธ์

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "travelMode": "DRIVE",
}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

การตอบกลับจะมีอาร์เรย์ geocodingResults ที่มีรหัสสถานที่สำหรับ ต้นทาง ปลายทาง และจุดแวะพัก 2 ใน 3 แห่ง ซึ่งเป็นจุดอ้างอิงที่ดัชนี 0 และ 2 ของคำขอ เนื่องจากมีการระบุจุดอ้างอิงที่ดัชนี 1 ของคำขอโดยใช้พิกัดละติจูด/ลองจิจูด ระบบจึงละเว้นจุดอ้างอิงดังกล่าวจากอาร์เรย์ geocodingResults ในการตอบกลับ

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}