כשאתם עוקבים אחרי נסיעה, המיקום של הרכב המתאים מוצג באפליקציה של הצרכן. כדי לעשות זאת, האפליקציה צריכה להתחיל לעקוב אחרי הנסיעה, לעדכן את התקדמות המסע במהלך הנסיעה ולהפסיק לעקוב אחרי הנסיעה כשהיא מסתיימת.
במסמך הזה מפורטים השלבים העיקריים בתהליך:
- הגדרת מפה
- איך מפעילים מפה ומציגים את המסלול המשותף
- עדכון הנסיעה ומעקב אחרי התקדמותה
- הפסקת המעקב אחרי נסיעה
- טיפול בשגיאות בנסיעות
הגדרת מפה
כדי לעקוב אחרי איסוף או מסירה של משלוח באפליקציית האינטרנט, צריך לטעון מפה וליצור מופע של Consumer SDK כדי להתחיל לעקוב אחרי התהליך. אפשר לטעון מפה חדשה או להשתמש במפה קיימת. לאחר מכן משתמשים בפונקציית האיפוס כדי ליצור מופע של Consumer SDK, כך שתצוגת המפה תתאים למיקום של הפריט שעליו מתבצע המעקב.
טעינת מפה חדשה באמצעות Google Maps JavaScript API
כדי ליצור מפה חדשה, צריך לטעון את Google Maps JavaScript API באפליקציית האינטרנט. בדוגמה הבאה מוסבר איך לטעון את Google Maps JavaScript API, להפעיל את ה-SDK ולהפעיל את בדיקת האיפוס.
- הפרמטר
callbackמפעיל את הפונקציהinitMapאחרי טעינת ה-API. - המאפיין
deferמאפשר לדפדפן להמשיך את העיבוד של שאר הדף בזמן טעינת ה-API.
משתמשים בפונקציה initMap כדי ליצור מופע של Consumer SDK. לדוגמה:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>
טעינת מפה קיימת
אפשר גם לטעון מפה קיימת שנוצרה באמצעות ממשק ה-API של JavaScript במפות Google, למשל מפה שכבר משתמשים בה.
לדוגמה, נניח שיש לכם דף אינטרנט עם ישות google.maps.Map רגילה שבה מוצג סמן כפי שמוגדר בקוד ה-HTML הבא. המפה מוצגת באמצעות אותה פונקציה initMap בקריאה החוזרת בסוף:
<!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>
החלפת מפה קיימת
אתם יכולים להחליף מפה קיימת שכוללת סמנים או התאמות אישיות אחרות, בלי לאבד את ההתאמות האלה.
לדוגמה, אם יש לכם דף אינטרנט עם ישות google.maps.Map רגילה שמוצג בה סמן, תוכלו להחליף את המפה ולשמור את הסמן. בקטע הזה מוסבר איך לעשות זאת.
כדי להחליף את המפה ולשמור על ההתאמות האישיות, מוסיפים את שיתוף המסלול לדף ה-HTML לפי השלבים הבאים, שממוספרים גם בדוגמה שבהמשך:
מוסיפים קוד למפעל האסימונים של האימות.
מאתחלים ספק מיקום בפונקציה
initMap().מאתחלים את תצוגת המפה בפונקציה
initMap(). התצוגה מכילה את המפה.מעבירים את ההתאמה האישית לפונקציית הקריאה החוזרת (callback) של יצירת תצוגת המפה.
מוסיפים את ספריית המיקומים למטען ה-API.
בדוגמה הבאה מוצגים השינויים שצריך לבצע. אם תפעילו נסיעה עם המזהה שציינתם ליד Uluru, היא תופיע עכשיו במפה:
<!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>
איך מפעילים מפה ומציגים את ההתקדמות בנסיעה
כשמתחילים נסיעה, האפליקציה צריכה ליצור מופע של ספק מיקום נסיעה ואז לאתחל מפה כדי להתחיל לשתף את התקדמות הנסיעה. דוגמאות מפורטות בקטעים הבאים.
יצירת מכונה של ספק מיקום נסיעה
ל-JavaScript SDK יש ספק מיקום מוגדר מראש ל-Fleet Engine Ridesharing API. כדי ליצור מופע של המכונה, משתמשים במזהה הפרויקט ובהפניה למפעל האסימונים.
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',
});
איך מאתחלים את תצוגת המפה
אחרי טעינת ה-SDK של JavaScript, מפעילים את תצוגת המפה ומוסיפים אותה לדף ה-HTML. הדף צריך להכיל רכיב <div> שמכיל את תצוגת המפה. שם הרכיב <div> הוא map_canvas בדוגמה הבאה.
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);
עדכון הנסיעה ומעקב אחרי התקדמותה
האפליקציה צריכה להאזין לאירועים ולעדכן את ההתקדמות בנסיעה במהלך המסע. אפשר לאחזר מטא-נתונים על נסיעה מאובייקט המשימה באמצעות ספק המיקום. המטא-נתונים כוללים את זמן ההגעה המשוער ואת המרחק שנותר עד לאיסוף או להורדה. שינויים במטא-נתונים מפעילים אירוע update. בדוגמה הבאה מוסבר איך להאזין לאירועי השינוי האלה.
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);
});
הפסקת המעקב אחרי נסיעה
בסיום הנסיעה, צריך להפסיק את המעקב אחר הנסיעה על ידי ספק המיקום. כדי לעשות זאת, מסירים את מזהה הנסיעה ואת ספק המיקום. דוגמאות מפורטות מופיעות בקטעים הבאים.
הסרת מזהה הנסיעה מספק המיקום
בדוגמה הבאה מוסבר איך להסיר מזהה נסיעה מספק המיקום.
JavaScript
locationProvider.tripId = '';
TypeScript
locationProvider.tripId = '';
הסרת ספק המיקום מתצוגת המפה
בדוגמה הבאה מוסבר איך להסיר ספק מיקום מתצוגת המפה.
JavaScript
mapView.removeLocationProvider(locationProvider);
TypeScript
mapView.removeLocationProvider(locationProvider);
טיפול בשגיאות בנסיעות
שגיאות שמתרחשות באופן אסינכרוני כתוצאה מהבקשה לקבלת פרטי נסיעה מפעילות אירועי שגיאה. בדוגמה הבאה מוסבר איך להאזין לאירועים האלה כדי לטפל בשגיאות.
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);
});