Routes Preferred API ช่วยให้ขอข้อมูลเกี่ยวกับสภาพการจราจรพร้อมกับโพลีไลน์ได้ สภาพการจราจรจะแสดงเป็นหมวดหมู่ความเร็ว (NORMAL, SLOW, TRAFFIC_JAM) ตามช่วงเวลาที่ระบุของเส้นประกอบคำตอบ ช่วงเวลาจะกำหนดโดยดัชนีของจุดเส้นตรงเริ่มต้น (รวม) และสิ้นสุด (ไม่รวม)
ตัวอย่างคำขอ
เส้นประกอบต่างๆ ที่รับรู้การจราจรพร้อมใช้งานทั้งในระดับเส้นทางและระดับขา
ที่ระดับเส้นทาง ระบบจะแสดงข้อมูลความเร็วของการจราจรเป็น SpeedReadingIntervals ในช่องตอบกลับ RouteTravelAdvisory
หากต้องการรับข้อมูลการจราจรตามเส้นประกอบของเส้นทาง ให้ใส่ทั้ง polyline
และ speedReadingIntervals
ในมาสก์ฟิลด์การตอบสนอง
หากฟิลด์มาสก์มี routes.legs.travelAdvisory.speedReadingIntervals
การตอบกลับจะมีข้อมูลการจราจรระดับขาในส่วน RouteLegTravelAdvisory
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline,routes.travelAdvisory.speedReadingIntervals,routes.legs.polyline.encodedPolyline,routes.legs.travelAdvisory.speedReadingIntervals
ไปที่ "เลือกช่องที่ต้องการส่งคืน" เพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับการระบุฟิลด์การตอบกลับ
คำตอบตัวอย่าง
ตราบใดที่มีคำขอ speedReadingIntervals
ผ่านมาสก์ฟิลด์ ระบบจะเติมค่าเหล่านี้ภายใต้ routes.travelAdvisory.speedReadingIntervals
การเข้าชมระดับขามาพร้อมให้บริการไม่เกิน routes.legs.travelAdvisory.speedReadingIntervals
ทุกช่วงเวลาอธิบายด้วยstartPolylinePointIndex
, endPolylinePointIndex
และหมวดหมู่ความเร็วที่เกี่ยวข้อง
โปรดทราบว่าการไม่มีดัชนีเริ่มต้นภายในช่วงสอดคล้องกับดัชนี 0 ตามแนวทางปฏิบัติของ Proto3
{ "routes": [ { "legs": { "polyline": { "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD" }, "travelAdvisory": { "speedReadingIntervals": [ { "endPolylinePointIndex": 1, "speed": "NORMAL" }, { "startPolylinePointIndex": 1, "endPolylinePointIndex": 2, "speed": "SLOW" }, { "startPolylinePointIndex": 2, "endPolylinePointIndex": 4, "speed": "NORMAL" } ] } }, "polyline": { "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD" }, "travelAdvisory": { "speedReadingIntervals": [ { "endPolylinePointIndex": 1, "speed": "NORMAL" }, { "startPolylinePointIndex": 1, "endPolylinePointIndex": 2, "speed": "SLOW" }, { "startPolylinePointIndex": 2, "endPolylinePointIndex": 4, "speed": "NORMAL" } ] } } ] }
แสดงผลโพลีไลน์การรับรู้การจราจรด้วย Maps SDK
เราขอแนะนำให้แสดงเส้นประกอบต่างๆ ที่รับรู้การจราจรบนแผนที่โดยใช้ฟีเจอร์ต่างๆ ที่ Google Maps SDK มีให้ใช้งาน รวมถึงการลงสี เส้น และลวดลายที่กำหนดเองตามแนวเส้นลาก ดูรายละเอียดเพิ่มเติมเกี่ยวกับการใช้โพลีไลน์ได้ที่หัวข้อฟีเจอร์ Polyline สำหรับ Android และฟีเจอร์ของ Polyline สำหรับ 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