In diesem Dokument wird beschrieben, wie Sie Fahrzeug- und Standortmarkierungen in der Karte anpassen, die Sie für Ihre webbasierte App zur Sendungsverfolgung für Verbraucher verwenden.
Mit dem JavaScript Consumer SDK können Sie das Erscheinungsbild von zwei Arten von Markierungen anpassen, die der Karte hinzugefügt werden:
- Markierungen für Lieferfahrzeuge: Verwenden Sie
deliveryVehicleMarkerCustomization. - Zielmarkierungen: Verwenden Sie
destinationMarkerCustomization.
Dazu hast du zwei Möglichkeiten:
- Am einfachsten: Geben Sie ein
MarkerOptions-Objekt an, das auf alle Markierungen desselben Typs angewendet werden soll. Das Consumer SDK wendet die Stile dann in zwei Situationen an: vor dem Hinzufügen der Markierungen zur Karte und wenn sich die für die Markierungen verwendeten Daten geändert haben. - Erweitert: Geben Sie eine Anpassungsfunktion an. Mit Anpassungsfunktionen können Sie die Markierungen anhand von Daten gestalten und interaktiv machen, z. B. durch Klick-Handling. Das Consumer SDK übergibt der Anpassungsfunktion Daten zum Typ des Objekts, das die Markierung darstellt: Fahrzeug oder Ziel. So kann der Stil der Markierung je nach aktuellem Zustand des Markierungselements geändert werden, z. B. die Anzahl der verbleibenden geplanten Stopps bis zum Ziel. Sie können sogar Daten aus Quellen außerhalb von Fleet Engine verknüpfen und die Markierung anhand dieser Informationen gestalten.
Einfaches Beispiel: MarkerOptions verwenden
Im folgenden Beispiel wird gezeigt, wie Sie den Stil einer Fahrzeugmarkierung mit einem MarkerOptions-Objekt konfigurieren. In diesem Beispiel wird die Deckkraft der Markierung auf 50 % festgelegt.
JavaScript
deliveryVehicleMarkerCustomization = {
opacity: 0.5
};
TypeScript
deliveryVehicleMarkerCustomization = {
opacity: 0.5
};
Erweitertes Beispiel: Anpassungsfunktion verwenden
Im folgenden Beispiel wird gezeigt, wie Sie den Stil einer Fahrzeugmarkierung so konfigurieren, dass die verbleibende Anzahl von Haltestellen für das Fahrzeug angezeigt wird, bevor es die Haltestelle für die geplante Aufgabe erreicht.
JavaScript
deliveryVehicleMarkerCustomization =
(params) => {
var stopsLeft = params.taskTrackingInfo.remainingStopCount;
params.marker.setLabel(`${stopsLeft}`);
};
TypeScript
deliveryVehicleMarkerCustomization =
(params: ShipmentMarkerCustomizationFunctionParams) => {
const stopsLeft = params.taskTrackingInfo.remainingStopCount;
params.marker.setLabel(`${stopsLeft}`);
};
Klickverarbeitung für Markierungen hinzufügen
Sie können jeder Markierung eine Klickverarbeitung hinzufügen, wie im folgenden Beispiel für eine Fahrzeugmarkierung.
JavaScript
deliveryVehicleMarkerCustomization =
(params) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
TypeScript
deliveryVehicleMarkerCustomization =
(params: ShipmentMarkerCustomizationFunctionParams) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
Zusätzliche Informationen zu Markierungen anzeigen
Sie können ein InfoWindow verwenden, um zusätzliche Informationen zu einer Fahrzeug- oder Ortsmarkierung anzuzeigen. Im folgenden Beispiel wird ein InfoWindow erstellt und an eine Fahrzeugmarkierung angehängt:
JavaScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
locationProvider.addListener('update', e => {
const stopsCount =
e.taskTrackingInfo.remainingStopCount;
infoWindow.setContent(
`Your vehicle is ${stopsCount} stops away.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
});
// 3. Close the info window.
infoWindow.close();
TypeScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent) => {
const stopsCount =
e.taskTrackingInfo.remainingStopCount;
infoWindow.setContent(
`Your vehicle is ${stopsCount} stops away.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
});
// 3. Close the info window.
infoWindow.close();