Bir seyahati takip ettiğinizde tüketici uygulaması, uygun aracın konumunu tüketiciye gösterir. Bunu yapmak için uygulamanızın geziyi takip etmeye başlaması, gezi sırasında yolculuk ilerleme durumunu güncellemesi ve gezi tamamlandığında takip etmeyi durdurması gerekir.
Bu dokümanda, bu süreçteki aşağıdaki temel adımlar ele alınmaktadır:
- Harita oluşturma
- Haritayı başlatma ve paylaşılan yolculuğu görüntüleme
- Gezi ilerleme durumunu güncelleme ve takip etme
- Bir geziyi takip etmeyi bırakma
- Gezi hatalarını işleme
Harita oluşturma
Web uygulamanızda bir gönderimin alınmasını veya teslim edilmesini takip etmek için bir harita yüklemeniz ve yolculuğunuzu izlemeye başlamak için Consumer SDK'sını örneklemeniz gerekir. Yeni bir harita yükleyebilir veya mevcut bir haritayı kullanabilirsiniz. Ardından, harita görünümünün izlenen öğenin konumuna karşılık gelmesi için Tüketici SDK'sını örneklemek üzere ilklendirme işlevini kullanırsınız.
Google Haritalar JavaScript API'yi kullanarak yeni bir harita yükleme
Yeni bir harita oluşturmak için Google Maps JavaScript API'yi web uygulamanıza yükleyin. Aşağıdaki örnekte, Google Maps JavaScript API'nin nasıl yükleneceği, SDK'nın nasıl etkinleştirileceği ve başlatma kontrolünün nasıl tetikleneceği gösterilmektedir.
callbackparametresi, API yüklendikten sonrainitMapişlevini çalıştırır.deferözelliği, API yüklenirken tarayıcının sayfanızı oluşturmaya devam etmesini sağlar.
Tüketici SDK'sını örneklemek için initMap işlevini kullanın. Örneğin:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>
Mevcut bir haritayı yükleme
Google Haritalar JavaScript API tarafından oluşturulmuş mevcut bir haritayı (ör. halihazırda kullandığınız bir harita) da yükleyebilirsiniz.
Örneğin, aşağıdaki HTML kodunda tanımlandığı şekilde bir işaretçi gösterilen standart bir google.maps.Map öğesi olan bir web sayfanız olduğunu varsayalım. Bu örnekte, sonunda geri çağırma işlevinde aynı initMap işlevi kullanılarak haritanız gösterilmektedir:
<!DOCTYPE html>
<html>
<head>
<style>
/* Set the size of the div element that contains the map */
#map {
height: 400px; /* The height is 400 pixels */
width: 100%; /* The width is the width of the web page */
}
</style>
</head>
<body>
<h3>My Google Maps Demo</h3>
<!--The div element for the map -->
<div id="map"></div>
<script>
// Initialize and add the map
function initMap() {
// The location of Pier 39 in San Francisco
var pier39 = {lat: 37.809326, lng: -122.409981};
// The map, initially centered at Mountain View, CA.
var map = new google.maps.Map(document.getElementById('map'));
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, now positioned at Pier 39
var marker = new google.maps.Marker({position: pier39, map: map});
}
</script>
<!-- Load the API from the specified URL.
* The defer attribute allows the browser to render the page while the API loads.
* The key parameter contains your own API key.
* The callback parameter executes the initMap() function.
-->
<script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>
</body>
</html>
Mevcut bir haritayı değiştirme
İşaretçi veya başka özelleştirmeler içeren mevcut bir haritayı, bu özelleştirmeleri kaybetmeden değiştirebilirsiniz.
Örneğin, işaretçi gösterilen standart bir google.maps.Map öğesi içeren bir web sayfanız varsa haritayı değiştirip işaretçiyi koruyabilirsiniz. Bu bölümde, bu işlemin adımları açıklanmaktadır.
Haritayı değiştirmek ve özelleştirmeleri korumak için aşağıdaki adımları uygulayarak HTML sayfanıza yolculuk paylaşımı ekleyin. Bu adımlar aşağıdaki örnekte de numaralandırılmıştır:
Kimlik doğrulama jetonu fabrikası için kod ekleyin.
initMap()işlevinde bir konum sağlayıcıyı başlatın.initMap()işlevinde harita görünümünü ilk kullanıma hazırlayın. Görünümde harita bulunur.Özelleştirmenizi, harita görünümü başlatma işlemi için geri arama işlevine taşıyın.
Konum kitaplığını API yükleyiciye ekleyin.
Aşağıdaki örnekte yapılacak değişiklikler gösterilmektedir. Uluru yakınlarında belirtilen kimliğe sahip bir gezi düzenlerseniz bu gezi artık haritada oluşturulur:
<!DOCTYPE html>
<html>
<head>
<style>
/* Set the size of the div element that contains the map */
#map {
height: 400px; /* The height is 400 pixels */
width: 100%; /* The width is the width of the web page */
}
</style>
</head>
<body>
<h3>My Google Maps Demo</h3>
<!--The div element for the map -->
<div id="map"></div>
<script>
let locationProvider;
// (1) Authentication Token Fetcher
async function authTokenFetcher(options) {
// options is a record containing two keys called
// serviceType and context. The developer should
// generate the correct SERVER_TOKEN_URL and request
// based on the values of these fields.
const response = await fetch(SERVER_TOKEN_URL);
if (!response.ok) {
throw new Error(response.statusText);
}
const data = await response.json();
return {
token: data.Token,
expiresInSeconds: data.ExpiresInSeconds
};
}
// Initialize and add the map
function initMap() {
// (2) Initialize location provider.
locationProvider = new google.maps.journeySharing.FleetEngineTripLocationProvider({
projectId: "YOUR_PROVIDER_ID",
authTokenFetcher,
});
// (3) Initialize map view (which contains the map).
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map'),
locationProviders: [locationProvider],
// any styling options
});
locationProvider.tripId = TRIP_ID;
// (4) Add customizations like before.
// The location of Pier 39 in San Francisco
var pier39 = {lat: 37.809326, lng: -122.409981};
// The map, initially centered at Mountain View, CA.
var map = new google.maps.Map(document.getElementById('map'));
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, now positioned at Pier 39
var marker = new google.maps.Marker({position: pier39, map: map});
};
</script>
<!-- Load the API from the specified URL
* The async attribute allows the browser to render the page while the API loads
* The key parameter will contain your own API key (which is not needed for this tutorial)
* The callback parameter executes the initMap() function
*
* (5) Add the SDK to the API loader.
-->
<script defer
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing">
</script>
</body>
</html>
Harita başlatma ve seyahat ilerleme durumunu görüntüleme
Bir gezi başladığında uygulamanızın, gezi ilerleme durumunu paylaşmaya başlamak için bir gezi konum sağlayıcısı oluşturması ve ardından bir harita başlatması gerekir. Örnekler için aşağıdaki bölümlere bakın.
Seyahat konum sağlayıcısı oluşturma
JavaScript SDK'sında, Fleet Engine Ridesharing API için önceden tanımlanmış bir konum sağlayıcı bulunur. Örnek oluşturmak için proje kimliğinizi ve jeton fabrikanıza ait bir referansı kullanın.
JavaScript
locationProvider =
new google.maps.journeySharing
.FleetEngineTripLocationProvider({
projectId: 'your-project-id',
authTokenFetcher: authTokenFetcher, // the token fetcher defined in the previous step
// Optionally, you may specify a trip ID to
// immediately start tracking.
tripId: 'your-trip-id',
});
TypeScript
locationProvider =
new google.maps.journeySharing
.FleetEngineTripLocationProvider({
projectId: 'your-project-id',
authTokenFetcher: authTokenFetcher, // the token fetcher defined in the previous step
// Optionally, you may specify a trip ID to
// immediately start tracking.
tripId: 'your-trip-id',
});
Harita görünümünü başlatma
JavaScript SDK'sını yükledikten sonra harita görünümünü başlatın ve HTML sayfasına ekleyin. Sayfanızda, harita görünümünü içeren bir <div> öğesi bulunmalıdır. Aşağıdaki örnekte <div> öğesi map_canvas olarak adlandırılmıştır.
JavaScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
// Styling customizations; see below.
vehicleMarkerSetup: vehicleMarkerSetup,
anticipatedRoutePolylineSetup:
anticipatedRoutePolylineSetup,
// Any undefined styling options will use defaults.
});
// If you did not specify a trip ID in the location
// provider constructor, you may do so here.
// Location tracking starts as soon as this is set.
locationProvider.tripId = 'your-trip-id';
// Give the map an initial viewport to allow it to
// initialize; otherwise, the 'ready' event above may
// not fire. The user also has access to the mapView
// object to customize as they choose.
mapView.map.setCenter({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);
TypeScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
// Styling customizations; see below.
vehicleMarkerSetup: vehicleMarkerSetup,
anticipatedRoutePolylineSetup:
anticipatedRoutePolylineSetup,
// Any undefined styling options will use defaults.
});
// If you did not specify a trip ID in the location
// provider constructor, you may do so here.
// Location tracking starts as soon as this is set.
locationProvider.tripId = 'your-trip-id';
// Give the map an initial viewport to allow it to
// initialize; otherwise, the 'ready' event above may
// not fire. The user also has access to the mapView
// object to customize as they choose.
mapView.map.setCenter({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);
Gezi ilerleme durumunu güncelleme ve takip etme
Uygulamanız, etkinlikleri dinlemeli ve yolculuk ilerledikçe gezi ilerleme durumunu güncellemelidir. Konum sağlayıcıyı kullanarak görev nesnesinden bir gezi hakkında meta bilgi alabilirsiniz. Meta bilgiler, tahmini varış saatini ve teslim alma veya bırakma noktasına kalan mesafeyi içerir. Meta bilgilerde yapılan değişiklikler bir güncelleme etkinliği tetikler. Aşağıdaki örnekte, bu değişiklik etkinliklerinin nasıl dinleneceği gösterilmektedir.
JavaScript
locationProvider.addListener('update', e => {
// e.trip contains data that may be useful
// to the rest of the UI.
console.log(e.trip.dropOffTime);
});
TypeScript
locationProvider.addListener('update', (e:
google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent) => {
// e.trip contains data that may be useful
// to the rest of the UI.
console.log(e.trip.dropOffTime);
});
Bir geziyi takip etmeyi bırakma
Gezi sona erdiğinde konum sağlayıcının geziyi izlemesini durdurmanız gerekir. Bunu yapmak için seyahat kimliğini ve konum sağlayıcıyı kaldırırsınız. Örnekler için aşağıdaki bölümlere bakın.
Seyahat kimliğini konum sağlayıcıdan kaldırma
Aşağıdaki örnekte, konum sağlayıcıdan bir gezi kimliğinin nasıl kaldırılacağı gösterilmektedir.
JavaScript
locationProvider.tripId = '';
TypeScript
locationProvider.tripId = '';
Konum sağlayıcıyı harita görünümünden kaldırma
Aşağıdaki örnekte, bir konum sağlayıcının harita görünümünden nasıl kaldırılacağı gösterilmektedir.
JavaScript
mapView.removeLocationProvider(locationProvider);
TypeScript
mapView.removeLocationProvider(locationProvider);
Gezi hatalarını işleme
Seyahat bilgileri istenirken eşzamansız olarak ortaya çıkan hatalar hata olaylarını tetikler. Aşağıdaki örnekte, hataları işlemek için bu etkinliklerin nasıl dinleneceği gösterilmektedir.
JavaScript
locationProvider.addListener('error', e => {
// e.error contains the error that triggered the
// event
console.error(e.error);
});
TypeScript
locationProvider.addListener('error', (e: google.maps.ErrorEvent) => {
// e.error contains the error that triggered the
// event
console.error(e.error);
});