Routes Preferred API を使用すると、ポリラインの交通状況に関する情報をリクエストできます。交通状況は、レスポンス ポリラインの特定の間隔に適用される速度カテゴリ(NORMAL、SLOW、TRAFFIC_JAM)で表現されます。間隔は、ポリラインの始点(境界を含む)と終点(終点を除く)のインデックスによって定義されます。
リクエストの例
交通認識ポリラインは、ルートレベルと区間レベルの両方で使用できます。ルートレベルでは、交通速度情報は RouteTravelAdvisory レスポンス フィールドの SpeedReadingIntervals として提供されます。ルートのポリラインとともに交通情報を受け取るには、レスポンス フィールド マスクに 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
、対応する速度カテゴリによって記述されます。区間内に開始インデックスがない場合、proto3 プラクティスに従ってインデックス 0 に対応します。
{ "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 が提供するさまざまな機能(ポリラインのストレッチに沿ったカスタムの色、ストローク、パターンなど)を使用して、交通状況を認識できるポリラインを地図上に表示することをおすすめします。 ポリラインの使い方について詳しくは、Android 用のポリライン対象物と iOS 用のポリライン対象物をご覧ください。
ポリラインのレンダリングの例
Maps SDK のユーザーは、速度カテゴリとポリライン レンダリング スキーマの間にカスタマイズしたマッピング ロジックを定義できます。たとえば、「NORMAL」は太い線で地図上に表示され、「SLOW」はオレンジ色の太い線で表示されるといった具合です。
以下のスニペットでは、メルボルンからパースへの測地線セグメントを持つ濃い青色のポリラインが追加されます。詳しくは、外観のカスタマイズ(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