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 przejazdu użytkownika w JavaScript, podczas tworzenia obiektu 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. Przykłady poniżej pokazują, jak stylować mapę za pomocą opcji mapy. Więcej informacji o opcjach mapy, które możesz ustawić, znajdziesz w mapOptions w dokumentacji API 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

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

Domyślna widoczność danych zadania

Domyślnie dane 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 zawiera domyślną widoczność każdego typu zadania. Widoczność możesz dostosować w przypadku wielu zadań, ale nie wszystkich. Więcej informacji o typach zadań znajdziesz w sekcji Typy zadań w przewodniku Zaplanowane zadania.

Rodzaj zadania Widoczność domyślna Czy można dostosować? Opis
Zadania dotyczące niedostępności Niewidoczna Nie Służy do przerw kierowcy 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ń związanych z pojazdem Widoczne Tak Widoczność kończy się po ukończeniu lub anulowaniu zadania. Możesz dostosować widoczność otwartych zadań związanych z pojazdem. Zobacz Dostosowywanie widoczności otwartych zadań dotyczących pojazdów.
Zamknięte zadania dotyczące pojazdów Niewidoczna 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 SDK dla konsumentów.

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

Linie łamane tras

Szacowany czas dotarcia

Szacowany czas ukończenia zadania

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

Pozostała liczba przystanków

Lokalizacja pojazdu

Opcje widoczności poszczególnych zadań

Możesz dostosować konfigurację widoczności dla każdego zadania, ustawiając parametr TaskTrackingViewConfig podczas tworzenia lub aktualizowania zadania w Fleet Engine. Aby utworzyć kryteria określania widoczności elementu zadania, użyj tych opcji widoczności:

Opcje widoczności

Pozostała liczba przystanków

Czas do szacowanego czasu przyjazdu

Pozostała odległość 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 inne 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 3 przystanków.
Szacowany czas dotarcia 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 3 przystanków.

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

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

Linie łamane trasy i zasady 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 łamanej 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 ustawiona na „nigdy nie jest widoczna”. Ustaw linie łamane trasy na nigdy niewidoczne.
Opcja widoczności to jedna z tych wartości:
  • pozostała liczba przystanków,
  • czas do szacowanego czasu dotarcia na miejsce
  • pozostały dystans 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: lokalizacja pojazdu i widoczność polilinii. 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?