Bu belgede, haritanın görünümünü ve tarzını özelleştirme, veri görünürlüğünü ve görüntü alanı seçeneklerini kontrol etme konuları ele alınmaktadır. Bunu aşağıdaki yöntemlerle yapabilirsiniz:
- Bulut tabanlı harita stillerini kullanma
- Harita stili seçeneklerini doğrudan kendi kodunuzda ayarlama
Bulut tabanlı harita stilleriyle haritayı stillendirme
JavaScript tüketici gezi paylaşımı haritanıza bir harita stili uygulamak için JourneySharingMapView oluştururken bir mapId ve diğer mapOptions öğelerini 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 bir haritanın nasıl stillendirileceği gösterilmektedir. Ayarlayabileceğiniz harita seçenekleri 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örevlerle ilgili veriler, araç göreve 5 durak mesafedeyken 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ü için varsayılan görünürlük gösterilir. Birçok görevin görünürlüğünü özelleştirebilirsiniz ancak tüm görevler için bu mümkün değildir. Görev türleri hakkında daha fazla bilgi için Programlanmış 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 |
|---|---|---|---|
| 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 rota başka bir araç durağı da içeriyorsa ve bu durakta yalnızca müsait olmama görevleri varsa bu durak gösterilmez. Teslimat görevinin kendisi için tahmini varış zamanı ve tahmini görev tamamlanma süresi gösterilmeye devam eder. |
| Açık araç görevleri | 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. |
| 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 bir dizi görev veri öğesi sağlar.
| Özelleştirilebilir görev verisi öğeleri | |
|---|---|
|
Rota çoklu çizgileri Tahmini varış süresi Tahmini görev tamamlama süresi |
Göreve kalan sürüş mesafesi 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 değerini 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 durak 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 |
|
Ö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 uzakta. |
| TVS | Göster | Kalan sürüş mesafesi 5.000 metreden az. |
| Kalan durak sayısı | Hiçbir zaman gösterme | Araç 3 durak uzakta. |
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ük kuralları
Araç konumu görünür değilse rota çoklu çizgileri de görünür olamaz. Aksi takdirde, araç konumu çoklu çizginin sonundan 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ü | Rehberlik |
|---|---|---|
| Rota çoklu çizgileri seçenekleri her zaman görünür olarak ayarlandı. | Araç konumunu her zaman görünür olarak ayarlayın. | |
| Araç konumu hiçbir zaman görünür olmayacak şekilde ayarlandı. | Rota çoklu çizgilerini hiçbir zaman görünür olmayacak şekilde ayarlayın. | |
Görünürlük seçeneği aşağıdakilerden biridir:
|
Rota çoklu çizgisi seçeneklerini, araç konumu için ayarlanan değere eşit veya bu değerden küçük 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 | Rehberlik |
| Araç konumu görünür durumda | Bu durum yalnızca hem araç konumu hem de çoklu çizgi görünürlüğü seçenekleri 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 sığdırmayı devre dışı bırakma
Otomatik sığdırmayı 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,
...
});