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 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. 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żna kontrolować widoczność niektórych obiektów zadań na mapie.

Domyślna widoczność danych zadań

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 zakończeniu lub anulowaniu zadania.

W tej tabeli przedstawiono domyślną widoczność dla 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.

Rodzaj zadania Widoczność domyślna Czy można dostosować? Opis
Zadania dotyczące niedostępności Niewidoczne Nie Służy do przerw kierowcy i tankowania. Jeśli trasa do zadania dostawy obejmuje również postój innego pojazdu, przystanek ten nie jest wyświetlany, jeśli zawiera wyłącznie zadania dotyczące niedostępności. Szacowany czas przyjazdu i szacowany czas ukończenia zadania są nadal wyświetlane w przypadku samego zadania dostawy.
Otwórz zadania 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 szereg elementów danych zadań, które można udostępnić za pomocą pakietu Consumer SDK.

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

Linie łamane trasy

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ń

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 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 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 tras nie mogą być widoczne, jeśli nie jest widoczna 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 jest ustawiona na nigdy niewidoczną. Ustaw linie poligonowe trasy tak, aby nigdy nie były widoczne.
Opcja widoczności może mieć jedną z tych wartości:
  • pozostała liczba przystanków
  • czas trwania 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ą obie opcje 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 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?