このドキュメントでは、一般ユーザー向けのウェブベースのルート トラッキング アプリで使用する地図のルート ポリラインをカスタマイズする方法について説明します。
Consumer SDK を使用すると、ルート ポリラインの可視性を制御したり、地図上のルートのルート ポリラインのスタイルを設定したりできます。SDK は、ルートのアクティブなパスまたは残りのパス内の座標ペアごとに google.maps.Polyline オブジェクトを作成します。ライブラリは、次の 2 つの状況でこれらのカスタマイズを適用します。
- 地図にオブジェクトを追加する前に
- オブジェクトに使用されているデータが変更された場合
ルート ポリラインのスタイルを設定する
マーカーのスタイル設定と同様に、カスタマイズ パラメータを使用してルート ポリラインのスタイルを設定します。次に、次のいずれかの方法でスタイル設定を構成します。
- 最もシンプル:
PolylineOptionsを使用して、一致するすべてのPolylineオブジェクトの作成または更新時に適用します。 - 詳細: カスタマイズ関数を指定します。カスタマイズ関数を使用すると、Fleet Engine から送信されたデータに基づいてオブジェクトのスタイルを個別に設定できます。この関数は、ルートの現在の状態に基づいて各オブジェクトのスタイルを変更できます。たとえば、
Polylineオブジェクトの色を濃くしたり、車両の速度が遅い場合は太くしたりできます。Fleet Engine の外部ソースと結合し、その情報に基づいてPolylineオブジェクトのスタイルを設定することもできます。
カスタマイズ パラメータ
ルート ポリラインのスタイル設定では、FleetEngineTripLocationProviderOptions で提供されるパラメータを使用します。これらのパラメータは、次のように車両の走行中のさまざまなパス状態に対応しています。
- すでに走行したパス:
takenPolylineCustomizationを使用します。 - 実際に移動したパス:
activePolylineCustomizationを使用します。 - まだ走行していないパス:
remainingPolylineCustomizationを使用します。
PolylineOptions
次の例は、PolylineOptions を使用して Polyline オブジェクトのスタイル設定を構成する方法を示しています。このパターンに沿って、前述のポリラインのカスタマイズを使用して Polyline オブジェクトのスタイルをカスタマイズします。
JavaScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
TypeScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
カスタマイズ関数を使用してルート ポリラインのスタイルを設定する
次の例は、アクティブなルート ポリラインのスタイル設定方法を示しています。上記のルート ポリラインのカスタマイズ パラメータを使用して、Polyline オブジェクトのスタイルをカスタマイズするには、このパターンに沿って操作します。
JavaScript
// Color the route polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params) => {
const distance = params.trip.remainingWaypoints[0].distanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
TypeScript
// Color the route Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params: TripPolylineCustomizationFunctionParams) => {
const distance = params.trip.remainingWaypoints[0].distanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
ルート ポリラインの公開設定を制御する
デフォルトでは、すべての Polyline オブジェクトが表示されます。Polyline オブジェクトを非表示にするには、その visible プロパティを設定します。
JavaScript
remainingPolylineCustomization = {visible: false};
TypeScript
remainingPolylineCustomization = {visible: false};