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