โดยค่าเริ่มต้น จุดอ้างอิงกลางจะใช้ในการหยุดสำหรับการรับสินค้าและการรับส่ง แต่คุณก็ระบุได้เช่นกันว่าจุดอ้างอิงระหว่างกลางมีไว้สำหรับให้ผ่านเท่านั้น
เส้นทางที่มีจุดอ้างอิงต้นทาง จุดอ้างอิงระหว่างกลาง และจุดอ้างอิงปลายทางมีเพียงเส้นทางเดียวที่เชื่อมต้นทางกับปลายทาง ขณะผ่านจุดระหว่างกลาง (เรียกว่า via
)
กำหนดค่าจุดอ้างอิงตรงกลางให้เป็นจุดอ้างอิงแบบส่งผ่านโดยการตั้งค่าพร็อพเพอร์ตี้ via
ของจุดอ้างอิงเป็น true
โดยใช้ Waypoint (REST) หรือ Waypoint (gRPC)
พร็อพเพอร์ตี้ via
จะมีประสิทธิภาพมากที่สุดเมื่อสร้างเส้นทางเมื่อผู้ใช้ลากจุดอ้างอิงในแผนที่ การทำเช่นนี้จะช่วยให้ผู้ใช้ดูลักษณะของเส้นทางสุดท้ายแบบเรียลไทม์ และช่วยให้มั่นใจว่ามีการวางจุดอ้างอิงในตำแหน่งที่เส้นทาง Compute เข้าถึงได้
ตัวอย่างต่อไปนี้แสดงวิธีทำเครื่องหมายจุดอ้างอิงกลางว่าเป็นจุดอ้างอิงแบบส่งผ่าน
{ "location": { "latLng": { "latitude":37.419734, "longitude":-122.0827784 } }, "via": true }
เข้าถึงรหัสสถานที่สำหรับจุดอ้างอิงระดับกลาง
หากคุณระบุตำแหน่งของต้นทาง จุดหมาย หรือจุดอ้างอิงตรงกลางเป็นสตริงที่อยู่หรือเป็น Plus Code API จะพยายามค้นหาตำแหน่งที่เกี่ยวข้องมากที่สุดซึ่งมีรหัสสถานที่ที่สอดคล้องกัน อาร์เรย์ geocodingResults.intermediates
ในผลการค้นหาจะมีรหัสสถานที่ที่สอดคล้องกับตำแหน่งของจุดอ้างอิง พร้อมด้วยข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่ง
สำหรับองค์ประกอบแต่ละรายการของอาร์เรย์ intermediates
ให้ใช้พร็อพเพอร์ตี้ intermediateWaypointRequestIndex
เพื่อระบุว่าจุดอ้างอิงระดับกลางใดในคำขอที่สอดคล้องกับรหัสสถานที่ในคำตอบ
เช่น
คุณระบุจุดอ้างอิงระดับกลาง 3 จุดในคำขอ จุดอ้างอิง 2 จุดจากสตริงที่อยู่และอีกจุดหนึ่งคือพิกัดละติจูด/ลองจิจูด
คุณใส่
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" } ] } }