ทั้งเมธอด computeRoutes (REST) และ ComputeRoutes (gRPC) จะแสดงผลลัพธ์เป็นเส้นทางที่แสดงด้วยเส้นประกอบเป็นส่วนหนึ่งของการตอบกลับ API เหล่านี้แสดงเส้นประกอบ 2 ประเภทดังนี้
เส้นประกอบพื้นฐาน (ค่าเริ่มต้น) แสดงเส้นทางแต่ไม่มีข้อมูลการจราจรที่ฝังอยู่ในเส้นประกอบ คำขอที่แสดงเส้นประกอบพื้นฐาน จะเรียกเก็บเงินในอัตราพื้นฐานของ Routes ดูข้อมูลเพิ่มเติมเกี่ยวกับ การเรียกเก็บเงินสำหรับ Routes API
เส้นประกอบที่รับรู้การจราจรได้ มีข้อมูลเกี่ยวกับสภาพการจราจร ตลอดเส้นทาง สภาพการจราจรจะแสดงในรูปแบบความเร็ว หมวดหมู่ (
NORMAL,SLOW,TRAFFIC_JAM) ที่เกี่ยวข้องในช่วงเวลาที่ระบุ เส้นประกอบ ระบบจะเรียกเก็บเงินคำขอสำหรับเส้นประกอบที่รับรู้การเข้าชมได้ที่ เส้นทางอัตราที่ต้องการ ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินสำหรับ Routes API โปรดดูรายละเอียดที่หัวข้อกำหนดคุณภาพของเส้นประกอบ
ดูข้อมูลเพิ่มเติมเกี่ยวกับเส้นประกอบได้ที่
ยูทิลิตีโปรแกรมเปลี่ยนไฟล์ Polyline แบบอินเทอร์แอกทีฟ ช่วยให้คุณสร้างเส้นประกอบที่เข้ารหัสใน UI หรือถอดรหัสเส้นประกอบที่จะแสดง แผนที่ เช่น ใช้ยูทิลิตีนี้เพื่อถอดรหัสเส้นประกอบที่สร้างขึ้นโดย ด้านล่าง
ขอเส้นประกอบพื้นฐานสำหรับเส้นทาง ช่วง หรือขั้นตอน
เส้นประกอบจะแสดงเป็นเส้น Polyline (REST) หรือ ออบเจ็กต์ Polyline (gRPC) คุณจะแสดงผลเส้นประกอบในคำตอบได้ที่ระดับเส้นทาง ขา และระดับก้าว
ระบุเส้นประกอบที่จะส่งคืนโดยใช้ มาสก์ของช่องตอบกลับ:
ที่ระดับเส้นทาง ให้แสดงผลรูปหลายเส้นในการตอบกลับโดยใส่
routes.polylineในมาสก์ช่องการตอบกลับที่ระดับขา ให้แสดงเส้นประกอบในการตอบสนองสำหรับขาแต่ละข้างของ เส้นทางโดยรวม
routes.legs.polylineที่ระดับขั้นตอน ให้แสดงผลรูปหลายเหลี่ยมในการตอบกลับสำหรับแต่ละขั้นตอนของขาโดยใส่
routes.legs.steps.polyline
เช่น ในการแสดงเส้นประกอบของทั้งเส้นทาง สำหรับขาแต่ละข้าง และสำหรับ ในแต่ละก้าวของแต่ละช่วง
curl -X POST -d '{ "origin":{ "address": "1600 Amphitheatre Parkway, Mountain View, CA" }, "destination":{ "address": "24 Willie Mays Plaza, San Francisco, CA 94107" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline,routes.legs.steps.polyline' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
คำขอนี้ส่งคืนการตอบกลับต่อไปนี้ซึ่งมีเส้นประกอบสำหรับ เส้นทาง แต่ละก้าวของเส้นทาง และสำหรับแต่ละขั้นตอนของขา
{ "routes": [ { "legs": [ { "polyline": { "encodedPolyline": "ipkcFfich...@Bs@?A?O?SD{A@o@B}@I?qA?_AA_@@_@?" } }, "steps": [ { "polyline": { "encodedPolyline": "kclcF...@sC@YIOKI" } }, { "polyline": { "encodedPolyline": "wblcF~...SZSF_@?" } }, ... ], "distanceMeters": 56901, "duration": "2420s", "polyline": { "encodedPolyline": "ipkcFfich...@Bs@?A?O?SD{A@o@B}@I?qA?_AA_@@_@?" } } ] }
เนื่องจากคำขอนี้มีเพียงต้นทางและปลายทาง คำขอที่แสดงผล เส้นทางมีเพียงขาเดียว ดังนั้น เส้นประกอบของช่วงและของเส้นทางจึงเหมือนกัน
หากคุณเพิ่มจุดอ้างอิงตรงกลางลงในคำขอ ค่าที่ส่งคืน เส้นทางมี 2 ส่วน ได้แก่
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"}, ], "travelMode": "DRIVE", }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
คำขอนี้แสดงขา 2 ข้าง แต่ละขามีเส้นประกอบที่ไม่ซ้ำกัน และเส้นประกอบสำหรับ เส้นทางทั้งหมด:
{ "routes": [ { "legs": [ { "polyline": { "encodedPolyline": "kclcFfqchV?A...?I@G?GAECCCEKICBAFG" } "steps": [ { "polyline": { "encodedPolyline": "kclcFfqch...YIOKI" } }, ... }, { "polyline": { "encodedPolyline": "ojmcFtethV?K...QOYQOGA?_@MUG[Ga@G" } "steps": [ { "polyline": { "encodedPolyline": "uypeFbo`jVgJq...PoBiC" } }, ... } ], "distanceMeters": 68403, "duration": "3759s", "polyline": { "encodedPolyline": "kclcFfqchV?A?CBKF[Ha...?GAECCCEKICBAFGJEBE" } } ] }
คุณภาพของเส้นประกอบ
คุณภาพของเส้นประกอบสามารถอธิบายได้ด้วยคำต่อไปนี้
ความแม่นยำของจุดลอยตัวของจุด
จุดจะระบุเป็นค่าละติจูดและลองจิจูด ซึ่งแสดงในรูปแบบทศนิยมแบบความแม่นยำเดี่ยว วิธีนี้ใช้ได้ผลดีกับค่าที่น้อย (ซึ่งแสดงได้อย่างแม่นยำ) แต่ความแม่นยำจะลดลงตามค่า เพิ่มขึ้นเนื่องจากข้อผิดพลาดในการปัดเศษทศนิยม
ใน computeRoutes เมธอด (REST) และ ComputeRoutes ซึ่งควบคุมโดย
polylineEncodingจำนวนจุดที่รวมกันเป็นเส้นประกอบ
ยิ่งมีจุดมาก เส้นพลาสติกจะยิ่งเนียนมากขึ้น (โดยเฉพาะอย่างยิ่ง เส้นโค้ง)
ใน computeRoutes เมธอด (REST) และ ComputeRoutes ซึ่งควบคุมโดย
polylineQuality
กำหนดค่าประเภทการเข้ารหัสเส้นประกอบ
ใช้ตัวเลือกคำขอ polylineEncoding เพื่อควบคุมประเภทเส้นประกอบ
พร็อพเพอร์ตี้ polylineEncoding ควบคุมว่าเส้นประกอบจะเข้ารหัสเป็น
ENCODED_POLYLINE (ค่าเริ่มต้น) ซึ่งหมายความว่า
รูปแบบอัลกอริทึมโพลีไลน์ที่เข้ารหัส
จะใช้ หรือ GEO_JSON_LINESTRING ซึ่งหมายความว่า
รูปแบบ GeoJSON LineString
จะถูกนำมาใช้
เช่น ในเนื้อหาคําขอ
curl -X POST -d '{ "origin":{ "address": "1600 Amphitheatre Parkway, Mountain View, CA" }, "destination":{ "address": "24 Willie Mays Plaza, San Francisco, CA 94107" }, "travelMode": "DRIVE", "polylineEncoding": "ENCODED_POLYLINE" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
กำหนดค่าคุณภาพโพลีไลน์
polylineQuality ระบุคุณภาพของเส้นประกอบเป็น HIGH_QUALITY หรือ
OVERVIEW (ค่าเริ่มต้น) ใน OVERVIEW เส้นประกอบจะเขียนขึ้นโดยใช้
จำนวนจุดและมีเวลาในการตอบสนองของคำขอต่ำกว่า HIGH_QUALITY
ตัวอย่างเช่น ในส่วนเนื้อหาของคำขอ
{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "travelMode": "DRIVE", "routingPreference": "TRAFFIC_AWARE", "polylineQuality": "HIGH_QUALITY", "polylineEncoding": "ENCODED_POLYLINE", "departureTime": "2023-10-15T15:01:23.045123456Z", ... }
ขอเส้นประกอบที่คำนึงถึงสภาพการจราจร
ตัวอย่างที่แสดงข้างต้นทั้งหมดจะแสดงผลเป็นเส้นประกอบพื้นฐาน ซึ่งก็คือเส้นประกอบที่ไม่มีข้อมูลการจราจร นอกจากนี้ คุณยังขอให้รูปหลายเหลี่ยมมี ข้อมูลการจราจรของเส้นทางนั้นๆ และในแต่ละขาของเส้นทาง
เส้นประกอบที่คำนึงถึงสภาพการจราจรมีข้อมูลเกี่ยวกับสภาพการจราจรตลอดเส้นทาง สภาพการจราจรแสดงในหมวดหมู่ความเร็ว
(NORMAL, SLOW, TRAFFIC_JAM) ในช่วงเวลาที่ระบุของคำตอบ
เส้นประกอบ ช่วงเวลาจะกำหนดโดยดัชนีของช่วงเริ่มต้น (รวม)
และสิ้นสุดจุดโพลีไลน์ (ไม่รวม)
ตัวอย่างเช่น คำตอบต่อไปนี้แสดงการเข้าชม NORMAL ระหว่างเส้นประกอบ
ประเด็นที่ 2 และ 4:
{ "startPolylinePointIndex": 2, "endPolylinePointIndex": 4, "speed": "NORMAL" }
หากต้องการส่งคําขอคํานวณเส้นประกอบที่คำนึงถึงสภาพการจราจร ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในคําขอ
ตั้งค่าช่องอาร์เรย์
extraComputationsเป็นTRAFFIC_ON_POLYLINEเพื่อเปิดใช้ การคำนวณการเข้าชมตั้งค่า
travelModeเป็นDRIVEหรือTWO_WHEELERคำขอสำหรับรูปแบบการเดินทางอื่นๆ จะแสดงข้อผิดพลาดระบุเส้นทาง
TRAFFIC_AWAREหรือTRAFFIC_AWARE_OPTIMALค่ากำหนดสูงสุดในคำขอ สําหรับข้อมูลเพิ่มเติม โปรดดูการกําหนดค่าคุณภาพเทียบกับ เวลาในการตอบสนองตั้งค่ามาสก์ฟิลด์การตอบกลับที่ระบุให้แสดงผลพร็อพเพอร์ตี้การตอบกลับ
ที่ระดับเส้นทาง ให้แสดงข้อมูลการเดินทางทั้งหมดในคำตอบภายใน รวมทั้ง
routes.travelAdvisoryในมาสก์ฟิลด์ตอบกลับ เพื่อกลับ เฉพาะข้อมูลการจราจร ระบุroutes.travelAdvisory.speedReadingIntervalsที่ระดับการเดินทาง ให้แสดงผลข้อมูลการเดินทางทั้งหมดในคำตอบสำหรับ แต่ละขาของเส้นทางโดยรวม
routes.legs.travelAdvisoryเพื่อกลับ เฉพาะข้อมูลการจราจร ระบุroutes.legs.travelAdvisory.speedReadingIntervals
curl -X POST -d '{ "origin":{ "address": "1600 Amphitheatre Parkway, Mountain View, CA" }, "destination":{ "address": "24 Willie Mays Plaza, San Francisco, CA 94107" }, "travelMode": "DRIVE", "extraComputations": ["TRAFFIC_ON_POLYLINE"], "routingPreference": "TRAFFIC_AWARE_OPTIMAL" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline,routes.travelAdvisory,routes.legs.travelAdvisory' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
ตัวอย่างการตอบสนองสำหรับเส้นประกอบที่รับรู้การเข้าชม
ในการตอบกลับ ข้อมูลการรับส่งข้อมูลจะได้รับการเข้ารหัสในเส้นประกอบและอยู่ใน
ช่อง travelAdvisory ประเภท
RouteLegTravelAdvisory
(ในแต่ละขา) และ
ออบเจ็กต์ RouteTravelAdvisory (เส้นทาง)
เช่น
{ "routes": [ { "legs": { "polyline": { "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD" }, // Traffic data for the leg. "travelAdvisory": { "speedReadingIntervals": [ { "endPolylinePointIndex": 1, "speed": "NORMAL" }, { "startPolylinePointIndex": 1, "endPolylinePointIndex": 2, "speed": "SLOW" }, { "startPolylinePointIndex": 2, "endPolylinePointIndex": 4, "speed": "NORMAL" } ] } }, "polyline": { "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD" }, // Traffic data for the route. "travelAdvisory": { "speedReadingIntervals": [ { "endPolylinePointIndex": 1, "speed": "NORMAL" }, { "startPolylinePointIndex": 1, "endPolylinePointIndex": 2, "speed": "SLOW" }, { "startPolylinePointIndex": 2, "endPolylinePointIndex": 4, "speed": "NORMAL" } ] } } ] }
ทั้ง RouteTravelAdvisory และ RouteLegTravelAdvisory มีช่องอาร์เรย์
ที่เรียกว่า speedReadingIntervals ที่มีข้อมูลความเร็วการจราจร ชิ้น
ในอาร์เรย์จะแสดงด้วย
SpeedReadingInterval (REST) หรือ
SpeedReadingInterval
(gRPC)
ออบเจ็กต์ SpeedReadingInterval มีการอ่านความเร็วสำหรับช่วงของเส้นทาง
เช่น NORMAL, SLOW หรือ TRAFFIC_JAM อาร์เรย์ของออบเจ็กต์ทั้งหมดครอบคลุม
เส้นประกอบทั้งหมดของเส้นทางโดยไม่ทับซ้อนกัน จุดเริ่มต้นของช่วงเวลาที่ระบุจะเหมือนกับจุดสิ้นสุดของช่วงเวลาก่อนหน้า
ทุกช่วงมีคำอธิบายตาม startPolylinePointIndex
endPolylinePointIndex และหมวดหมู่ความเร็วที่เกี่ยวข้อง
โปรดสังเกตว่าการขาดดัชนีเริ่มต้นภายในช่วงสอดคล้องกับดัชนี 0
ตาม
โปรโตคอล 3 ที่สามารถนำมาใช้ได้
ค่า startPolylinePointIndex และ endPolylinePointIndex ไม่เท่ากัน
แบบเรียงต่อกันเสมอ เช่น
{ "startPolylinePointIndex": 2, "endPolylinePointIndex": 4, "speed": "NORMAL" }
ในกรณีนี้ สภาพการจราจรจากดัชนี 2 ถึงดัชนี 4 เหมือนกัน
แสดงผลเส้นประกอบที่คำนึงถึงสภาพการจราจรด้วย Maps SDK
เราแนะนำให้แสดงเส้นประกอบการรับรู้การจราจรบนแผนที่โดยใช้ ฟีเจอร์ของ Google Maps SDK รวมถึงการลงสีที่กำหนดเอง เส้นโครงร่าง และ ลวดลายตามเส้นโพลีไลน์ที่ยืดออก ดูรายละเอียดเพิ่มเติมเกี่ยวกับการใช้เส้นประกอบได้ที่ฟีเจอร์เส้นประกอบสำหรับ Android และฟีเจอร์เส้นประกอบสำหรับ iOS
ตัวอย่างการแสดงผลโพลีไลน์
ผู้ใช้ Maps SDK มีโอกาสกำหนดการแมปที่กำหนดเอง ระหว่างหมวดหมู่ความเร็วและสคีมาการแสดงผลโพลีไลน์ ในฐานะ ตัวอย่างเช่น ผู้เข้าชมอาจตัดสินใจแสดงคำว่า "ปกติ" เป็นเส้นหนาสีน้ำเงินบน แผนที่ขณะ "ช้า" ความเร็วอาจแสดงเป็นเส้นหนาสีส้ม เป็นต้น
ข้อมูลโค้ดต่อไปนี้เพิ่มเส้นประกอบสีน้ำเงินหนาพร้อมส่วนที่มีกรอบเรขาคณิตจาก จากเมลเบิร์นไปเพิร์ท สำหรับข้อมูลเพิ่มเติม โปรดดู การปรับแต่งลักษณะที่ปรากฏ (สำหรับ Android) และ ปรับแต่งเส้นประกอบ (สำหรับ iOS)
Android
Java
Polyline line = map.addPolyline(new PolylineOptions() .add(new LatLng(-37.81319, 144.96298), new LatLng(-31.95285, 115.85734)) .width(25) .color(Color.BLUE) .geodesic(true));
Kotlin
val line: Polyline = map.addPolyline( PolylineOptions() .add(LatLng(-37.81319, 144.96298), LatLng(-31.95285, 115.85734)) .width(25f) .color(Color.BLUE) .geodesic(true) )
iOS
Objective-C
GMSMutablePath *path = [GMSMutablePath path]; [path addLatitude:-37.81319 longitude:144.96298]; [path addLatitude:-31.95285 longitude:115.85734]; GMSPolyline *polyline = [GMSPolyline polylineWithPath:path]; polyline.strokeWidth = 10.f; polyline.strokeColor = .blue; polyline.geodesic = YES; polyline.map = mapView;
Swift
let path = GMSMutablePath() path.addLatitude(-37.81319, longitude: 144.96298) path.addLatitude(-31.95285, longitude: 115.85734) let polyline = GMSPolyline(path: path) polyline.strokeWidth = 10.0 polyline.geodesic = true polyline.map = mapView