ขอข้อมูลการจราจรในโพลีไลน์

Routes Preferred API ให้คุณขอข้อมูลเกี่ยวกับสภาพการจราจรได้ตลอดเส้นประกอบ สภาพการจราจรจะแสดงเป็นหมวดหมู่ความเร็ว (ปกติ ช้า รถติด) ซึ่งมีผลกับช่วงเวลาหนึ่งๆ ของเส้นประกอบคำตอบ ช่วงเวลาจะกำหนดโดยดัชนีของจุดเริ่มต้น (รวม) และจุดสิ้นสุด (ไม่รวม) ของเส้นประกอบ

ตัวอย่างคำขอ

เส้นประกอบที่คำนึงถึงสภาพการจราจรพร้อมใช้งานทั้งในระดับเส้นทางและระดับช่วง ที่ระดับเส้นทาง ระบบจะแสดงข้อมูลความเร็วการจราจรเป็น 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 ผ่านฟิลด์มาสก์ ระบบจะป้อนข้อมูล 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