Haritanın stilini ayarlama

Bu belgede, haritanın görünümünü ve tarzını özelleştirme, veri görünürlüğünü ve görünüm alanı seçeneklerini kontrol etme konuları ele alınmaktadır. Bunu aşağıdaki yöntemlerle yapabilirsiniz:

  • Bulut tabanlı harita stilini kullanma
  • Harita stili seçeneklerini doğrudan kendi kodunuzda ayarlama

Haritayı bulut tabanlı harita stilleriyle stilize etme

JavaScript tüketici yolculuğu paylaşım haritanıza bir harita stili uygulamak için JourneySharingMapView oluştururken bir mapId ve diğer mapOptions'leri belirtin.

Aşağıdaki örneklerde, harita kimliğiyle harita stilinin nasıl uygulanacağı gösterilmektedir.

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.
});

Haritaları doğrudan kendi kodunuzda stilize etme

JourneySharingMapView oluştururken harita seçeneklerini ayarlayarak harita stilini de özelleştirebilirsiniz. Aşağıdaki örneklerde, harita seçenekleri kullanılarak haritanın nasıl stilize edileceği gösterilmektedir. Hangi harita seçeneklerini ayarlayabileceğiniz hakkında daha fazla bilgi için Google Maps JavaScript API referansındaki mapOptions bölümüne bakın.

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" }
        ]
      }
    ]
  }
});

Görev verilerinin SDK'ya görünürlüğünü kontrol etme

Görünürlük kurallarını kullanarak haritadaki belirli görev nesnelerinin görünürlüğünü kontrol edebilirsiniz.

Görev verilerinin varsayılan görünürlüğü

Varsayılan olarak, bir araca atanan görevlerin verileri araç, görevden 5 durak uzaktayken görünür. Görünürlük, görev tamamlandığında veya iptal edildiğinde sona erer.

Bu tabloda, her görev türünün varsayılan görünürlüğü gösterilir. Birçok görevin görünürlüğünü özelleştirebilirsiniz ancak tüm görevlerin görünürlüğünü özelleştiremezsiniz. Görev türleri hakkında daha fazla bilgi için Planlanmış görevler kılavuzundaki Görev türleri başlıklı makaleyi inceleyin.

Görev türü Varsayılan görünürlük Özelleştirilebilir mi? Açıklama
Müsaitlik durumu görevleri Görünmez Hayır Sürücü molaları ve yakıt ikmali için kullanılır. Bir teslimat görevine giden rotada başka bir araç durağı da varsa ve bu durakta yalnızca müsait olmama görevleri varsa bu durak gösterilmez. Tahmini varış zamanı ve tahmini görev tamamlama süresi, teslimat görevi için gösterilmeye devam eder.
Araç görevlerini açma Visible Evet Görünürlük, görev tamamlandığında veya iptal edildiğinde sona erer. Açık araç görevlerinin görünürlüğünü özelleştirebilirsiniz. Açık araç görevlerinin görünürlüğünü özelleştirme başlıklı makaleyi inceleyin.
Kapatılan araç görevleri Görünmez Hayır Kapatılan araç görevlerinin görünürlüğünü özelleştiremezsiniz.

Açık araç görevlerinin görünürlüğünü özelleştirme

TaskTrackingInfo arayüzü, Consumer SDK ile görünür hale getirilebilecek bir dizi görev verisi öğesi sağlar.

Özelleştirilebilir görev verisi öğeleri

Rota çoklu çizgileri

Tahmini varış zamanı

Tahmini görev tamamlama süresi

Göreve kalan sürüş mesafesi

Kalan durma sayısı

Araç konumu

Görev başına görünürlük seçenekleri

Fleet Engine'de bir görev oluştururken veya güncellerken TaskTrackingViewConfig simgesini ayarlayarak görünürlük yapılandırmasını görev bazında özelleştirebilirsiniz. Bir görev öğesinin görünürlüğünü belirlemek için ölçüt oluşturmak üzere aşağıdaki görünürlük seçeneklerini kullanın:

Görünürlük seçenekleri

Kalan durma sayısı

Tahmini varış zamanına kadar geçen süre

Kalan sürüş mesafesi

Her zaman görünür

Hiçbir zaman görünmez

Örneğin, bir özelleştirmenin aşağıdaki tabloda gösterilen ölçütleri kullanarak üç veri öğesinin görünürlüğünü ayarladığını varsayalım. Diğer tüm öğeler varsayılan görünürlük kurallarına uyar.

Ayarlanacak veri öğesi Görünürlük Ölçüt
Rota çoklu çizgisi Göster Araç 3 durak içinde olmalıdır.
TVS Göster Kalan sürüş mesafesi 5.000 metreden kısadır.
Kalan durma sayısı Hiçbir zaman gösterme Araç 3 durak içinde olmalıdır.

Aşağıdaki örnekte bu yapılandırma gösterilmektedir:

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

Rota çoklu çizgileri ve araç konumu görünürlüğü kuralları

Rota çoklu çizgileri, araç konumu da görünür olmadığı sürece görünemez. Aksi takdirde araç konumu, çoklu çizginin sonundan tahmin edilebilir.

Bu kurallar, rota poliline ve araç konumu görünürlüğü seçenekleri için geçerli bir kombinasyon sağlamanıza yardımcı olur.

Aynı görünürlük seçenekleri Görünürlük ölçütü Yardımcı bilgiler
Rota çoklu çizgi seçenekleri her zaman görünür olarak ayarlanır. Araç konumunu her zaman görünür olarak ayarlayın.
Araç konumu hiçbir zaman görünür olmayacak şekilde ayarlanmış. Rota çoklu çizgilerini hiçbir zaman görünür olmayacak şekilde ayarlayın.
Görünürlük seçeneği şunlardan biri olmalıdır:
  • kalan durak sayısı
  • TVS'ye kadar olan süre
  • kalan sürüş mesafesi

Rota çoklu çizgi seçeneklerini, araç konumu için ayarlanan değerden küçük veya bu değere eşit bir değere ayarlayın. Örneğin:

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
Farklı görünürlük seçenekleri Görünürlük ölçütleri Yardımcı bilgiler
Araç konumu görünür

Bu durum yalnızca araç konumu ve çoklu çizgi görünürlüğü seçeneklerinin ikisi de karşılandığında gerçekleşir. Örneğin:

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

Bu örnekte, araç konumu yalnızca kalan durak sayısı en az 3 VE kalan sürüş mesafesi en az 3.000 metre olduğunda görünür.

Otomatik sığdırmayı devre dışı bırakma

Otomatik sığdırma özelliğini devre dışı bırakarak haritanın, görünüm alanını araca ve tahmini rotaya otomatik olarak sığdırmasını durdurabilirsiniz. Aşağıdaki örnekte, yolculuk paylaşımı harita görünümünü yapılandırırken otomatik sığdırmanın nasıl devre dışı bırakılacağı gösterilmektedir.

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,
  ...
});

Sırada ne var?