Haritanın stilini ayarlama

Bu dokümanda, haritaların görünümünü ve tarzını özelleştirmenin yanı sıra veri görünürlüğünü ve görüntü alanı seçeneklerini kontrol etme hakkında bilgiler verilmektedir. Bunu aşağıdaki yöntemlerle yapabilirsiniz:

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

Bulut tabanlı harita stilleri ile haritaya stil uygulama

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

Aşağıdaki örneklerde, harita kimliğiyle bir 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 biçimlendirme

JourneySharingMapView'yi oluştururken harita seçeneklerini ayarlayarak da harita stilini özelleştirebilirsiniz. Aşağıdaki örneklerde, harita seçenekleri kullanılarak bir haritaya nasıl stil verileceği gösterilmektedir. Ayarlayabileceğiniz harita seçenekleri hakkında daha fazla bilgi için Google Maps JavaScript API referansında 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 haritada belirli görev nesnelerinin görünürlüğünü kontrol edebilirsiniz.

Görev verileri için varsayılan görünürlük

Bir araca atanan görevlerle ilgili veriler varsayılan olarak araç, görevden 5 durak uzaklıktayken görünür. Görev tamamlandığında veya iptal edildiğinde görünürlük sona erer.

Bu tabloda, her görev türünün varsayılan görünürlüğü gösterilmektedir. Görevlerin görünürlüğünü özelleştirebilirsiniz ancak tümünü değil. Görev türleri hakkında daha fazla bilgi için Planlanmış görevler kılavuzundaki Görev türleri bölümüne bakın.

Görev türü Varsayılan görünürlük Özelleştirilebilir mi? Açıklama
Kullanılamazlık görevleri Görünmez Hayır Sürücünün molaları ve yakıt ikmali için kullanılır. Bir teslimat görevine giden rota başka bir araç durağı da içeriyorsa ve bu durak yalnızca "Kullanılamıyor" görevleri içeriyorsa bu durak gösterilmez. Teslimat görevi için tahmini varış zamanı ve tahmini görev tamamlama zamanı gösterilmeye devam eder.
Araç görevlerini açma Gösteriliyor Evet Görev tamamlandığında veya iptal edildiğinde görünürlük 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.
Kapalı araç görevleri Görünmez Hayır Kapalı 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ü, Tüketici SDK'sı ile görünür hale getirilebilecek çeşitli görev verisi öğeleri sağlar.

Özelleştirilebilir görev verisi öğeleri

Rota çoklu çizgileri

Tahmini varış zamanı

Görevin tahmini tamamlanma süresi

Göreve arabayla kalan mesafe

Kalan durak sayısı

Araç konumu

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

Fleet Engine'da görev oluştururken veya güncellerken TaskTrackingViewConfig ayarını yaparak 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 durak sayısı

Tahmini varış saatine kadar geçen süre

Kalan sürüş mesafesi

Her zaman görünür

Hiçbir zaman görünmez

Örnek olarak, 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 uzaklıktadır.
TVS Göster Kalan sürüş mesafesi 5.000 metreden kısaysa
Kalan durak sayısı Hiçbir zaman gösterme Araç 3 durak uzaklıktadır.

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

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

Rota poli çizgileri ve araç konumu görünürlük kuralları

Araç konumu da görünmediği sürece rota çoklu çizgileri görünmez. Aksi takdirde, araç konumu bir çoklu çizginin sonuna göre tahmin edilebilir.

Bu kurallar, rota çoklu çizgisi ve araç konumu görünürlük 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ü Yönerge
Rota çoklu çizgileri 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 olarak ayarlanmış. Rota poli çizgilerini hiçbir zaman görünmeyecek şekilde ayarlayın.
Görünürlük seçeneği aşağıdakilerden biri olmalıdır:
  • kalan durak sayısı
  • GMR'ye kadar geçen süre
  • kalan sürüş mesafesi

Rota çoklu çizgisi seçeneklerini, araç konumu için ayarlanan değerden daha 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 Yönerge
Araç konumu görünür

Bu durum yalnızca araç konumu ve poli çizgisi 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 ise görünür.

Otomatik uyumluluğu devre dışı bırakma

Otomatik uyumu devre dışı bırakarak haritanın görüntü alanını araca ve beklenen 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?