Określanie stylu mapy

Z tego dokumentu dowiesz się, jak dostosować wygląd mapy oraz kontrolować widoczność danych i opcje widoku. 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

Nadawanie stylu mapie za pomocą definiowania stylów map w Google Cloud

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

Poniższe przykłady pokazują, jak zastosować styl mapy z identyfikatorem 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.
});

Nadawanie stylu mapom bezpośrednio w kodzie

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

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 zadań dla pakietu SDK

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

Domyślna widoczność danych zadania

Domyślnie dane dotyczące zadań przypisanych do pojazdu są widoczne, gdy pojazd znajduje się w odległości 5 przystanków od zadania. Widoczność kończy się po ukończeniu lub anulowaniu zadania.

Ta tabela pokazuje domyślną widoczność każdego typu zadania. Widoczność wielu zadań można dostosować, ale nie wszystkich. Więcej informacji o typach zadań znajdziesz w sekcji Typy zadań w przewodniku Zaplanowane zadania.

Typ zadania Widoczność domyślna Możliwość dostosowania Opis
Zadania dotyczące niedostępności Niewidoczne Nie Służy do przerw i tankowania. Jeśli trasa do zadania dostawy zawiera też inny przystanek pojazdu, nie jest on wyświetlany, jeśli zawiera tylko zadania niedostępności. Szacowany czas przyjazdu i szacowany czas ukończenia zadania są nadal wyświetlane w przypadku samego zadania dostawy.
Otwieranie zadań dotyczących pojazdu Widoczne Tak Widoczność kończy się po ukończeniu lub anulowaniu zadania. Możesz dostosować widoczność otwartych zadań dotyczących pojazdów. Zobacz Dostosowywanie widoczności otwartych zadań dotyczących pojazdów.
Zakończone zadania dotyczące pojazdów Niewidoczne Nie Nie możesz dostosowywać widoczności zamkniętych zadań dotyczących pojazdów.

Dostosowywanie widoczności otwartych zadań dotyczących pojazdów

Interfejs TaskTrackingInfo udostępnia wiele elementów danych zadań, które można wyświetlać za pomocą pakietu Consumer SDK.

Elementy danych zadań z możliwością dostosowania

Linie łamane tras

Szacowany czas dotarcia

Szacowany czas ukończenia zadania

pozostałą odległość dojazdu do zadania,

Pozostała liczba przystanków

Lokalizacja pojazdu

Opcje widoczności poszczególnych zadań

Konfigurację widoczności możesz dostosować do poszczególnych zadań, ustawiając TaskTrackingViewConfig podczas tworzenia lub aktualizowania zadania w Fleet Engine. Aby utworzyć kryteria określające widoczność elementu zadania, użyj tych opcji widoczności:

Opcje widoczności

Pozostała liczba przystanków

Czas do szacowanej godziny przyjazdu

Pozostały dystans do przejechania

Zawsze widoczne

Nigdy nie wyświetla się

Załóżmy, że przykładowe dostosowanie zmienia widoczność 3 elementów danych na podstawie kryteriów podanych w tabeli poniżej. Wszystkie pozostałe elementy podlegają domyślnym regułom widoczności.

Element danych do dostosowania Widoczność Kryterium
Linia łamana trasy Pokaż Pojazd znajduje się w odległości maksymalnie 3 przystanków.
Szacowany czas zakończenia Pokaż Pozostała odległość do przejechania jest mniejsza niż 5000 metrów.
Pozostała liczba przystanków Nigdy nie pokazuj Pojazd znajduje się w odległości maksymalnie 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, chyba że widoczna jest również 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 trasy i lokalizacji pojazdu.

Te same opcje widoczności Kryterium widoczności Wskazówki
Opcje polilinii trasy ustawione na zawsze widoczne. Ustaw lokalizację pojazdu na zawsze widoczną.
Lokalizacja pojazdu jest ustawiona na nigdy niewidoczną. Ustawianie polilinii trasy na zawsze niewidoczne.
Opcja widoczności może mieć jedną z tych wartości:
  • liczba pozostałych przystanków,
  • czas do szacowanego czasu dotarcia,
  • pozostała odległość do przejechania,

Ustaw opcje polilinii 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. Na przykład:

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

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

Wyłączanie automatycznego dopasowywania

Możesz wyłączyć automatyczne dopasowywanie, aby mapa nie dopasowywała automatycznie widoku do pojazdu i przewidywanej trasy. Poniższy przykład pokazuje, jak wyłączyć automatyczne dopasowywanie podczas konfigurowania widoku mapy udostępniania trasy.

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?