Określanie stylu mapy

Z tego dokumentu dowiesz się, jak dostosować wygląd i działanie mapy oraz kontrolować widoczność danych i opcje widocznego obszaru. Możesz to zrobić na te sposoby:

  • Korzystanie z definiowania stylów map w Google Cloud
  • Ustawianie opcji stylu mapy bezpośrednio we własnym kodzie

Definiowanie stylów map w Google Cloud

Aby zastosować styl mapy do mapy udostępniania przejazdów konsumenta w języku JavaScript, podczas tworzenia JourneySharingMapView określ mapId i inne mapOptions.

Poniższe przykłady pokazują, jak zastosować styl mapy za pomocą identyfikatora mapy.

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

nadawać styl mapom bezpośrednio we własnym kodzie,

Możesz też dostosować styl mapy, ustawiając opcje mapy podczas tworzenia obiektu JourneySharingMapView. Poniższe przykłady pokazują, jak stylizować mapę za pomocą opcji mapy. Więcej informacji o opcjach mapy, które możesz ustawić, znajdziesz w dokumentacji interfejsu Google Maps JavaScript API: mapOptions.

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

Kontrolowanie widoczności danych zadania dla pakietu SDK

Widoczność niektórych obiektów zadań na mapie możesz kontrolować za pomocą reguł widoczności.

Domyślna widoczność danych zadania

Domyślnie dane dotyczące zadań przypisanych do pojazdu są widoczne, gdy pojazd znajduje się w odległości nie większej niż 5 przystanków od zadania. Widoczność kończy się, gdy zadanie zostanie ukończone lub anulowane.

Ta tabela przedstawia domyślną widoczność każdego typu zadania. Możesz dostosować widoczność wielu zadań, ale nie wszystkich. Więcej informacji o typach zadań znajdziesz w sekcji Typy zadań w przewodniku po zaplanowanych zadaniach.

Typ zadania Widoczność domyślna Możliwość dostosowania? Opis
Zadania związane z niedostępnością Niewidoczna Nie Służy do przerw dla kierowców i tankowania. Jeśli trasa do zadania dostawy zawiera też inny przystanek pojazdu, ten przystanek nie jest wyświetlany, jeśli zawiera tylko zadania niedostępności. Szacowany czas przybycia i szacowany czas ukończenia zadania są nadal wyświetlane w przypadku samego zadania dostawy.
Otwarte zadania dotyczące pojazdów Widoczne Tak Widoczność kończy się, gdy zadanie zostanie ukończone lub anulowane. Możesz dostosować widoczność otwartych zadań związanych z pojazdem. Zobacz Dostosowywanie widoczności otwartych zadań związanych z pojazdami.
Zakończone zadania dotyczące pojazdów Niewidoczna Nie Nie możesz dostosować widoczności zamkniętych zadań związanych z pojazdami.

Dostosowywanie widoczności otwartych zadań pojazdu

Interfejs TaskTrackingInfo udostępnia szereg elementów danych zadania, które można wyświetlić za pomocą pakietu SDK dla konsumentów.

Elementy danych zadania z możliwością dostosowania

Linie łamane trasy

Szacowany czas dotarcia na miejsce

Szacowany czas ukończenia zadania

pozostała odległość do zadania,

Liczba pozostałych przystanków

Lokalizacja pojazdu

Opcje widoczności dla każdego zadania

Konfigurację widoczności możesz dostosować dla każdego zadania, ustawiając TaskTrackingViewConfig podczas tworzenia lub aktualizowania zadania we Fleet Engine. Aby utworzyć kryteria określające widoczność elementu zadania, użyj tych opcji widoczności:

Opcje widoczności

Liczba pozostałych przystanków

Czas do szacowanego czasu przyjazdu

pozostały dystans do przejechania,

Zawsze widoczne

Nigdy niewidoczne

Załóżmy, że przykładowe dostosowanie zmienia widoczność 3 elementów danych na podstawie kryteriów przedstawionych w tabeli poniżej. Wszystkie inne elementy są zgodne z domyślnymi regułami widoczności.

Element danych do dostosowania Widoczność Kryterium
Linia łamana trasy Pokaż Pojazd jest w odległości 3 przystanków.
Szacowany czas dotarcia Pokaż Pozostała odległość do przejechania jest mniejsza niż 5000 metrów.
Liczba pozostałych przystanków Nigdy nie pokazuj Pojazd jest w odległości 3 przystanków.

Poniższy przykład pokazuje tę konfigurację:

"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

Linie łamane trasy i reguły widoczności lokalizacji pojazdu

Linie łamane trasy nie mogą być widoczne, jeśli nie jest widoczna lokalizacja pojazdu. W przeciwnym razie lokalizację pojazdu można wywnioskować na podstawie końca linii łamanej.

Te wytyczne pomogą Ci podać prawidłową kombinację opcji widoczności linii łamanej trasy i lokalizacji pojazdu.

Te same opcje widoczności Kryterium widoczności Wskazówki
Opcje linii łamanych trasy są ustawione jako zawsze widoczne. Ustaw lokalizację pojazdu jako zawsze widoczną.
Lokalizacja pojazdu jest ustawiona jako nigdy niewidoczna. Ustaw linie łamane trasy jako nigdy niewidoczne.
Opcja widoczności to:
  • pozostała liczba przystanków
  • czas do szacowanego czasu dotarcia na miejsce,
  • pozostały dystans do przejechania

Ustaw opcje linii łamanej trasy na wartość mniejszą lub równą wartości ustawionej dla lokalizacji pojazdu. Na przykład:

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
różne opcje widoczności, Kryteria widoczności Wskazówki
Lokalizacja pojazdu jest widoczna

Dzieje się tak tylko wtedy, gdy spełnione są oba warunki dotyczące lokalizacji pojazdu i widoczności linii łamanej. Na przykład:

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

W tym przykładzie lokalizacja pojazdu jest widoczna tylko wtedy, gdy liczba pozostałych przystanków wynosi co najmniej 3 ORAZ pozostała odległość do przejechania wynosi co najmniej 3000 metrów.

Wyłącz automatyczne dopasowywanie

Możesz wyłączyć automatyczne dopasowywanie widocznego obszaru do pojazdu i przewidywanej trasy. Poniższy przykład pokazuje, jak wyłączyć automatyczne dopasowywanie podczas konfigurowania widoku mapy udostępniania przejazdu.

JavaScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

TypeScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

Co dalej?