Panoramica
Puoi calcolare le indicazioni stradali (utilizzando una serie di metodi di trasporto) utilizzando l'oggetto DirectionsService
. Questo oggetto comunica con il servizio Directions dell'API di Google Maps, che riceve le richieste di indicazioni stradali e restituisce un percorso efficiente.
Il tempo di percorrenza è il fattore principale che viene ottimizzato, ma possono essere presi in considerazione altri fattori come la distanza, il numero di svolte e molto altro.
Puoi gestire personalmente i risultati di queste indicazioni stradali o utilizzare l'oggetto DirectionsRenderer
per eseguire il rendering di questi risultati.
Quando specifichi l'origine o la destinazione in una richiesta di indicazioni stradali, puoi specificare una stringa di query (ad esempio, "Chicago, IL" o "Darwin, NSW, Australia"), un valore LatLng
o un oggetto Place.
Il servizio Directions può restituire indicazioni a più parti utilizzando una serie di tappe. Le indicazioni stradali vengono visualizzate come una polilinea che traccia il percorso su una mappa o anche come una serie di descrizioni testuali all'interno di un elemento <div>
(ad esempio, "Sulla destra sulla rampa del ponte di Williamsburg").
Per cominciare
Prima di utilizzare il servizio Directions nell'API Maps JavaScript, assicurati che l'API Directions sia abilitata in Google Cloud Console, nello stesso progetto che hai configurato per l'API Maps JavaScript.
Per visualizzare l'elenco delle API abilitate:
- Vai alla console Google Cloud.
- Fai clic sul pulsante Seleziona un progetto, seleziona lo stesso progetto che hai impostato per l'API Maps JavaScript e fai clic su Apri.
- Nell'elenco delle API nella Dashboard, cerca API Directions.
- Se vedi l'API nell'elenco, significa che è tutto a posto. Se l'API non è elencata, abilitala:
- Nella parte superiore della pagina, seleziona ABILITA API per visualizzare la scheda Libreria. In alternativa, seleziona Raccolta dal menu laterale a sinistra.
- Cerca l'API Directions, quindi selezionala dall'elenco dei risultati.
- Seleziona ABILITA. Al termine del processo, l'API Directions apparirà nell'elenco delle API nella Dashboard.
Prezzi e norme
Prezzi
A partire dal 16 luglio 2018, è entrato in vigore un nuovo piano tariffario con pagamento a consumo per Maps, Routes e Places. Per scoprire di più sui nuovi prezzi e sui limiti di utilizzo per il servizio JavaScript Directions, consulta la pagina relativa all'utilizzo e alla fatturazione dell'API Directions.
Criteri
L'utilizzo del servizio Directions deve essere conforme alle norme descritte per l'API Directions.
Richieste di indicazioni stradali
L'accesso al servizio Directions è asincrono, poiché l'API Google Maps deve effettuare una chiamata a un server
esterno. Per questo motivo, devi superare un metodo di callback da eseguire al completamento della richiesta. Questo
metodo di callback dovrebbe elaborare i risultati. Tieni presente che il servizio Indicazioni stradali può restituire più di un possibile itinerario come array di routes[]
separati.
Per utilizzare le indicazioni stradali nell'API Maps JavaScript, crea un oggetto
di tipo DirectionsService
e chiama
DirectionsService.route()
per avviare una richiesta
al servizio Directions, trasmettendole un
valore letterale di oggetto
DirectionsRequest
contenente i termini di input e un metodo di callback da eseguire
alla ricezione della risposta.
Il valore letterale dell'oggetto DirectionsRequest
contiene i seguenti campi:
{ origin: LatLng | String | google.maps.Place, destination: LatLng | String | google.maps.Place, travelMode: TravelMode, transitOptions: TransitOptions, drivingOptions: DrivingOptions, unitSystem: UnitSystem, waypoints[]: DirectionsWaypoint, optimizeWaypoints: Boolean, provideRouteAlternatives: Boolean, avoidFerries: Boolean, avoidHighways: Boolean, avoidTolls: Boolean, region: String }
Questi campi sono spiegati di seguito:
origin
(obbligatorio) specifica la posizione di partenza da cui calcolare le indicazioni stradali. Questo valore può essere specificato comeString
(ad esempio, "Chicago, IL"), come valoreLatLng
o come oggetto Place. Se utilizzi un oggetto Place, puoi specificare un ID luogo, una stringa di query o una localitàLatLng
. Puoi recuperare gli ID dei luoghi dai servizi di geocodifica, ricerca di luoghi e completamento automatico dei luoghi nell'API Maps JavaScript. Per un esempio di ID luogo di Auto Place Autocomplete, consulta Place Autocomplete and Directions.destination
(obbligatorio) specifica la posizione finale a cui calcolare le indicazioni stradali. Le opzioni sono le stesse del campoorigin
descritto sopra.travelMode
(obbligatorio) specifica la modalità di trasporto da utilizzare per il calcolo delle indicazioni stradali. I valori validi sono specificati in Modalità di viaggio qui sotto.transitOptions
(facoltativo) specifica i valori che si applicano solo alle richieste in cuitravelMode
èTRANSIT
. I valori validi sono descritti in Opzioni di trasporto pubblico di seguito.drivingOptions
(facoltativo) specifica i valori che si applicano solo alle richieste in cuitravelMode
èDRIVING
. I valori validi sono descritti nella sezione Opzioni di guida di seguito.unitSystem
(facoltativo) specifica il sistema di unità da utilizzare quando si visualizzano i risultati. I valori validi sono specificati in Unità di sistema di seguito.waypoints[]
(facoltativo) specifica un array diDirectionsWaypoint
s. I Waypoint alterano un percorso indirizzandolo attraverso le località specificate. Un waypoint è specificato come valore letterale oggetto con i campi mostrati di seguito:location
specifica la posizione del punto di accesso, comeLatLng
, come oggetto Place o comeString
che verrà geocodificato.stopover
è un valore booleano che indica che il punto di riferimento è una fermata lungo il percorso, con l'effetto di dividere il percorso in due percorsi.
Per ulteriori informazioni sui tappe, consulta la sezione Usare i tappe nei percorsi di seguito.
optimizeWaypoints
(facoltativo) specifica che la route che utilizza l'waypoints
specificato può essere ottimizzata riorganizzando i tappe in un ordine più efficiente. Setrue
, il servizio Directions restituirà ilwaypoints
riordinato in un campowaypoint_order
. Per ulteriori informazioni, consulta la sezione Utilizzo dei Waypoint nelle route di seguito.provideRouteAlternatives
(facoltativo) se impostato sutrue
specifica che il servizio Directions può fornire più di un'alternativa di percorso nella risposta. Tieni presente che l'invio di alternative di route potrebbe aumentare il tempo di risposta dal server. Questa opzione è disponibile solo per le richieste senza tappe intermedie.avoidFerries
(facoltativo) se impostato sutrue
indica che i percorsi calcolati devono evitare i traghetti, se possibile.avoidHighways
(facoltativo) se impostato sutrue
indica che le route calcolate devono evitare le autostrade principali, se possibile.avoidTolls
(facoltativo) se impostato sutrue
indica che i percorsi calcolati devono evitare strade a pedaggio, se possibile.region
(facoltativo) specifica il codice di area geografica, specificato come valore di ccTLD ("dominio di primo livello") a due caratteri. (per saperne di più, consulta Differenziazione per area geografica di seguito).
Di seguito è riportato un esempio DirectionsRequest
:
{ origin: 'Chicago, IL', destination: 'Los Angeles, CA', waypoints: [ { location: 'Joplin, MO', stopover: false },{ location: 'Oklahoma City, OK', stopover: true }], provideRouteAlternatives: false, travelMode: 'DRIVING', drivingOptions: { departureTime: new Date(/* now, or future date */), trafficModel: 'pessimistic' }, unitSystem: google.maps.UnitSystem.IMPERIAL }
Modalità di viaggio
Per calcolare le indicazioni stradali, devi specificare la modalità di trasporto da utilizzare. Le seguenti modalità di viaggio sono attualmente supportate:
DRIVING
(Predefinito) indica le indicazioni stradali standard tramite la rete stradale.BICYCLING
richiede indicazioni in bicicletta tramite piste ciclabili e strade preferite.TRANSIT
richiede le indicazioni stradali tramite linee di trasporto pubblico.WALKING
richiede indicazioni a piedi tramite percorsi pedonali e marciapiedi.
Consulta i dettagli relativi alla copertura di Google Maps Platform per determinare in che misura un paese supporta le indicazioni stradali. Se richiedi
indicazioni stradali per una regione in cui tale tipo di direzione non è disponibile,
la risposta restituirà
DirectionsStatus
="ZERO_RESULTS
".
Nota: le indicazioni a piedi potrebbero non includere percorsi pedonali
chiari, quindi le indicazioni a piedi restituiranno avvisi in
DirectionsResult
. Questi avvisi devono sempre essere mostrati all'utente. Se non utilizzi il DirectionsRenderer
predefinito, sei responsabile di assicurarti che vengano mostrati gli avvisi.
Opzioni di trasporto pubblico
Le opzioni disponibili per le richieste di indicazioni stradali variano in base alle modalità di viaggio.
Quando richiedi le indicazioni stradali per il trasporto pubblico, le opzioni avoidHighways
, avoidTolls
, waypoints[]
e optimizeWaypoints
verranno ignorate. Puoi specificare le opzioni di routing specifiche per il trasporto pubblico tramite il valore letterale dell'oggetto TransitOptions
.
Le indicazioni stradali relative al trasporto pubblico sono urgenti. Le indicazioni stradali verranno restituite solo per gli orari futuri.
Il valore letterale oggetto TransitOptions
contiene i seguenti
campi:
{ arrivalTime: Date, departureTime: Date, modes[]: TransitMode, routingPreference: TransitRoutePreference }
Questi campi sono spiegati di seguito:
arrivalTime
(facoltativo) specifica l'orario di arrivo desiderato come oggettoDate
. Se è specificato l'ora di arrivo, l'orario di partenza viene ignorato.departureTime
(facoltativo) specifica l'orario di partenza desiderato come oggettoDate
.departureTime
verrà ignorato searrivalTime
è specificato. Il valore predefinito è adesso (ovvero l'ora attuale) se non viene specificato alcun valore perdepartureTime
oarrivalTime
.modes[]
(facoltativo) è un array contenente uno o più valori letterali di oggettoTransitMode
. Questo campo può essere incluso solo se la richiesta include una chiave API. OgniTransitMode
specifica la modalità di trasporto pubblico preferita. Sono consentiti i seguenti valori:BUS
indica che il percorso calcolato dovrebbe preferire il viaggio in autobus.RAIL
indica che il percorso calcolato dovrebbe preferire il viaggio in treno, tram, metropolitana leggera e metropolitana.SUBWAY
indica che il percorso calcolato dovrebbe preferire il viaggio in metropolitana.TRAIN
indica che il percorso calcolato dovrebbe preferire il viaggio in treno.TRAM
indica che il percorso calcolato dovrebbe preferire il viaggio in tram e la metropolitana leggera.
routingPreference
(facoltativo) specifica le preferenze per i percorsi dei trasporti pubblici. Utilizzando questa opzione, puoi polizzare le opzioni restituite, anziché accettare la route migliore predefinita scelta dall'API. Questo campo può essere specificato solo se la richiesta include una chiave API. Sono consentiti i seguenti valori:FEWER_TRANSFERS
indica che la route calcolata dovrebbe preferire un numero limitato di cambi.LESS_WALKING
indica che il percorso calcolato dovrebbe preferire un numero limitato di passeggiate.
Di seguito è riportato un esempio di trasporto pubblico (DirectionsRequest
):
{ origin: 'Hoboken NJ', destination: 'Carroll Gardens, Brooklyn', travelMode: 'TRANSIT', transitOptions: { departureTime: new Date(1337675679473), modes: ['BUS'], routingPreference: 'FEWER_TRANSFERS' }, unitSystem: google.maps.UnitSystem.IMPERIAL }
Opzioni di guida
Puoi specificare le opzioni di routing per le indicazioni stradali tramite l'oggetto
DrivingOptions
.
L'oggetto DrivingOptions
contiene i seguenti campi:
{ departureTime: Date, trafficModel: TrafficModel }
Questi campi sono spiegati di seguito:
departureTime
(obbligatorio affinché il valore letterale dell'oggettodrivingOptions
sia valido) specifica l'orario di partenza desiderato come oggettoDate
. Il valore deve essere impostato sull'ora attuale o su una data futura. Non può essere un passato. L'API converte tutte le date in UTC per garantire una gestione coerente dei fusi orari. Per i clienti di Google Maps Platform Premium Plan, se includidepartureTime
nella richiesta, l'API restituisce il percorso migliore in base alle condizioni di traffico previste al momento e include nella risposta il tempo previsto nel traffico (duration_in_traffic
). Se non specifichi un orario di partenza (ovvero se la richiesta non includedrivingOptions
), il percorso restituito è in genere una buona strada senza tenere conto delle condizioni del traffico.trafficModel
(facoltativo) specifica le ipotesi da utilizzare per il calcolo del tempo di traffico. Questa impostazione influisce sul valore restituito nel campoduration_in_traffic
della risposta, che contiene il tempo previsto nel traffico in base alle medie storiche. Il valore predefinito èbestguess
. Sono consentiti i seguenti valori:bestguess
(valore predefinito) indica cheduration_in_traffic
restituiti rappresenta la stima migliore del tempo di percorrenza dato quanto noto e storico delle condizioni del traffico e del traffico in tempo reale. Il traffico in tempo reale diventa più importante man mano che si avvicina ildepartureTime
.pessimistic
indica che il valore restituito diduration_in_traffic
dovrebbe essere più lungo del tempo di percorrenza effettivo nella maggior parte dei giorni, anche se i giorni occasionali con condizioni del traffico particolarmente scarse possono superare questo valore.optimistic
indica che il valore diduration_in_traffic
restituito dovrebbe essere inferiore al tempo di percorrenza effettivo della maggior parte dei giorni, sebbene i giorni occasionali con condizioni del traffico particolarmente elevate potrebbero essere più rapidi di questo valore.
Di seguito è riportato un esempio di DirectionsRequest
per le indicazioni stradali:
{ origin: 'Chicago, IL', destination: 'Los Angeles, CA', travelMode: 'DRIVING', drivingOptions: { departureTime: new Date(Date.now() + N), // for the time N milliseconds from now. trafficModel: 'optimistic' } }
Unità di misura
Per impostazione predefinita, le indicazioni stradali vengono calcolate e visualizzate utilizzando il sistema di unità del paese o dell'area geografica di origine.
(Nota: le origini espresse utilizzando le coordinate di latitudine/longitudine anziché gli indirizzi vengono sempre impostate come unità di misura predefinite). Ad esempio, un percorso da
"Chicago, IL" a "Toronto, ONT" mostrerà i risultati in miglia, mentre
il percorso inverso mostrerà i risultati in chilometri. Puoi
eseguire l'override di questo sistema unitario impostandone uno esplicitamente nella
richiesta utilizzando uno dei seguenti valori
UnitSystem
:
UnitSystem.METRIC
specifica l'utilizzo del sistema delle metriche. Le distanze vengono mostrate utilizzando i chilometri.UnitSystem.IMPERIAL
specifica l'utilizzo del sistema imperiale. Le distanze vengono mostrate utilizzando le miglia.
Nota:questa impostazione del sistema per le unità influisce solo sul testo mostrato all'utente. Il risultato delle indicazioni stradali contiene anche valori di distanza, non mostrati all'utente, che sono sempre espressi in metri.
Differenziazione della regione per le indicazioni stradali
Il servizio Directions dell'API di Google Maps restituisce i risultati relativi all'indirizzo influenzati dal dominio (area geografica o paese) da cui hai caricato il bootstrap JavaScript. Poiché la maggior parte degli utenti carica https://maps.googleapis.com/
,
viene impostato un dominio implicito negli Stati Uniti. Se carichi il bootstrap di un dominio supportato diverso, i risultati saranno influenzati dal dominio. Ad esempio, le ricerche di "San Francisco" potrebbero restituire risultati diversi dalle applicazioni che caricano https://maps.googleapis.com/
(Stati Uniti) rispetto a quelle che caricano http://maps.google.es/
(Spagna).
Puoi anche impostare il servizio Directions per restituire i risultati di bias a una
regione specifica utilizzando il parametro region
. Questo parametro accetta un codice regione, specificato come sottotag di regione Unicode di due caratteri (non numerico). Nella maggior parte dei casi, questi tag vengono mappati direttamente a valori ccTLD ("dominio di primo livello"), ad esempio "uk" in "co.uk". In alcuni casi, il tag region
supporta anche i codici ISO-3166-1, che a volte differiscono dai valori ccTLD ("GB" per "Gran Bretagna").
Quando utilizzi il parametro region
:
- Specifica solo un paese o una regione. Più valori vengono ignorati e potrebbero comportare una richiesta non riuscita.
- Utilizza solo sottotag di due caratteri per la regione (formato Unicode CLDR). Tutti gli altri input genereranno errori.
La differenziazione per area geografica è supportata solo per i paesi e le aree geografiche che supportano le indicazioni stradali. Consulta i dettagli sulla copertura di Google Maps Platform per conoscere la copertura internazionale per l'API Directions.
Indicazioni stradali per il rendering
L'avvio di una richiesta di indicazioni stradali per
DirectionsService
con il metodo route()
richiede il passaggio di un callback che viene eseguito al completamento
della richiesta di servizio. Questo callback restituirà un
codice DirectionsResult
e un codice DirectionsStatus
nella risposta.
Stato della query con indicazioni stradali
DirectionsStatus
potrebbe restituire i seguenti valori:
OK
indica che la risposta contiene unDirectionsResult
valido.NOT_FOUND
indica che non è stato possibile geocodificare almeno una delle località specificate nell'origine, nella destinazione o nei tappe della richiesta.ZERO_RESULTS
indica che non è stato trovato alcun percorso tra l'origine e la destinazione.MAX_WAYPOINTS_EXCEEDED
indica che sono stati forniti troppi campiDirectionsWaypoint
inDirectionsRequest
. Consulta la sezione di seguito sui limiti per i punti di accesso.MAX_ROUTE_LENGTH_EXCEEDED
indica che la route richiesta è troppo lunga e non può essere elaborata. Questo errore si verifica quando vengono restituite indicazioni più complesse. Prova a ridurre il numero di tappe, svolte o istruzioni.INVALID_REQUEST
indica che il valoreDirectionsRequest
fornito non era valido. Le cause più comuni di questo codice di errore sono le richieste prive di origine o di destinazione o di una richiesta di trasporto pubblico che include tappe.OVER_QUERY_LIMIT
indica che la pagina web ha inviato troppe richieste nel periodo di tempo consentito.REQUEST_DENIED
indica che la pagina web non è autorizzata a utilizzare il servizio indicazioni stradali.UNKNOWN_ERROR
indica che non è stato possibile elaborare una richiesta di indicazioni stradali a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprova.
Prima di elaborare il risultato, devi assicurarti che la query delle indicazioni stradali restituisca risultati validi.
Visualizzazione di DirectionsResult
DirectionsResult
contiene il risultato della query delle indicazioni stradali, che puoi gestire tu stesso, o passare a un oggetto DirectionsRenderer
, che può gestire automaticamente la visualizzazione del risultato su una mappa.
Per visualizzare un DirectionsResult
utilizzando un
DirectionsRenderer
, devi fare quanto segue:
- Crea un oggetto
DirectionsRenderer
. - Chiama
setMap()
sul renderer per associarlo alla mappa passata. - Chiama
setDirections()
sul renderer, trasmettendolo aDirectionsResult
come indicato sopra. Poiché il renderer è unMVCObject
, rileva automaticamente eventuali modifiche alle sue proprietà e aggiorna la mappa quando le indicazioni stradali associate cambiano.
L'esempio seguente calcola le indicazioni stradali tra due località sulla Route 66, dove l'origine e la destinazione vengono impostate dai valori "start"
e "end"
specificati negli elenchi a discesa. DirectionsRenderer
gestisce la visualizzazione della polilinea tra le posizioni indicate e il posizionamento degli indicatori all'origine, alla destinazione e, se applicabile, a eventuali Waypoint.
function initMap() { var directionsService = new google.maps.DirectionsService(); var directionsRenderer = new google.maps.DirectionsRenderer(); var chicago = new google.maps.LatLng(41.850033, -87.6500523); var mapOptions = { zoom:7, center: chicago } var map = new google.maps.Map(document.getElementById('map'), mapOptions); directionsRenderer.setMap(map); } function calcRoute() { var start = document.getElementById('start').value; var end = document.getElementById('end').value; var request = { origin: start, destination: end, travelMode: 'DRIVING' }; directionsService.route(request, function(result, status) { if (status == 'OK') { directionsRenderer.setDirections(result); } }); }
Nel corpo HTML:
<div> <strong>Start: </strong> <select id="start" onchange="calcRoute();"> <option value="chicago, il">Chicago</option> <option value="st louis, mo">St Louis</option> <option value="joplin, mo">Joplin, MO</option> <option value="oklahoma city, ok">Oklahoma City</option> <option value="amarillo, tx">Amarillo</option> <option value="gallup, nm">Gallup, NM</option> <option value="flagstaff, az">Flagstaff, AZ</option> <option value="winona, az">Winona</option> <option value="kingman, az">Kingman</option> <option value="barstow, ca">Barstow</option> <option value="san bernardino, ca">San Bernardino</option> <option value="los angeles, ca">Los Angeles</option> </select> <strong>End: </strong> <select id="end" onchange="calcRoute();"> <option value="chicago, il">Chicago</option> <option value="st louis, mo">St Louis</option> <option value="joplin, mo">Joplin, MO</option> <option value="oklahoma city, ok">Oklahoma City</option> <option value="amarillo, tx">Amarillo</option> <option value="gallup, nm">Gallup, NM</option> <option value="flagstaff, az">Flagstaff, AZ</option> <option value="winona, az">Winona</option> <option value="kingman, az">Kingman</option> <option value="barstow, ca">Barstow</option> <option value="san bernardino, ca">San Bernardino</option> <option value="los angeles, ca">Los Angeles</option> </select> </div>
L'esempio seguente mostra le indicazioni stradali utilizzando diverse modalità di viaggio tra Haight-Ashbury e Ocean Beach a San Francisco, California:
function initMap() { var directionsService = new google.maps.DirectionsService(); var directionsRenderer = new google.maps.DirectionsRenderer(); var haight = new google.maps.LatLng(37.7699298, -122.4469157); var oceanBeach = new google.maps.LatLng(37.7683909618184, -122.51089453697205); var mapOptions = { zoom: 14, center: haight } var map = new google.maps.Map(document.getElementById('map'), mapOptions); directionsRenderer.setMap(map); } function calcRoute() { var selectedMode = document.getElementById('mode').value; var request = { origin: haight, destination: oceanBeach, // Note that JavaScript allows us to access the constant // using square brackets and a string value as its // "property." travelMode: google.maps.TravelMode[selectedMode] }; directionsService.route(request, function(response, status) { if (status == 'OK') { directionsRenderer.setDirections(response); } }); }
Nel corpo HTML:
<div> <strong>Mode of Travel: </strong> <select id="mode" onchange="calcRoute();"> <option value="DRIVING">Driving</option> <option value="WALKING">Walking</option> <option value="BICYCLING">Bicycling</option> <option value="TRANSIT">Transit</option> </select> </div>
Un DirectionsRenderer
non solo gestisce la visualizzazione della polilinea e di eventuali indicatori associati, ma può anche gestire la visualizzazione testuale delle indicazioni stradali come una serie di passaggi. A tale scopo, chiama setPanel()
sul tuo
DirectionsRenderer
, trasmettendolo il <div>
in cui visualizzare queste informazioni.
In questo modo avrai anche la certezza di mostrare le informazioni di copyright
appropriate e gli eventuali avvisi associati al
risultato.
Le indicazioni testuali vengono fornite utilizzando l'impostazione della lingua preferita del browser o la lingua specificata durante il caricamento del codice JavaScript dell'API utilizzando il parametro language
. Per maggiori informazioni, consulta la pagina
Localizzazione. Per le indicazioni di trasporto pubblico, l'ora viene visualizzata nel fuso orario della fermata.
L'esempio seguente è identico a quello mostrato sopra,
ma include un riquadro <div>
in cui
visualizzare le indicazioni stradali:
function initMap() { var directionsService = new google.maps.DirectionsService(); var directionsRenderer = new google.maps.DirectionsRenderer(); var chicago = new google.maps.LatLng(41.850033, -87.6500523); var mapOptions = { zoom:7, center: chicago } var map = new google.maps.Map(document.getElementById('map'), mapOptions); directionsRenderer.setMap(map); directionsRenderer.setPanel(document.getElementById('directionsPanel')); } function calcRoute() { var start = document.getElementById('start').value; var end = document.getElementById('end').value; var request = { origin:start, destination:end, travelMode: 'DRIVING' }; directionsService.route(request, function(response, status) { if (status == 'OK') { directionsRenderer.setDirections(response); } }); }
Nel corpo HTML:
<div id="map" style="float:left;width:70%;height:100%"></div> <div id="directionsPanel" style="float:right;width:30%;height:100%"></div>
Oggetto DirectionsResult
Quando invii una richiesta di indicazioni stradali a
DirectionsService
, ricevi una risposta composta da
un codice di stato e un risultato, che è un oggetto
DirectionsResult
. DirectionsResult
è un valore letterale di oggetto con i seguenti campi:
geocoded_waypoints[]
contiene un array di oggettiDirectionsGeocodedWaypoint
, ognuno contenente dettagli sulla geocodifica di origine, destinazione e tappe.routes[]
contiene un array di oggettiDirectionsRoute
. Ogni route indica un modo per andare dall'origine alla destinazione fornita inDirectionsRequest
. In genere, viene restituita solo una route per ogni richiesta, a meno che il campoprovideRouteAlternatives
della richiesta non sia impostato sutrue
, in cui è possibile restituire più route.
Nota: la proprietà via_waypoint
viene ritirata in percorsi alternativi. La versione 3.27 è l'ultima versione dell'API che aggiunge extra tramite tappe
in route alternative. Per le versioni 3.28 e successive dell'API, puoi continuare a implementare le indicazioni trascinabili utilizzando il servizio Directions disattivando il trascinamento delle route alternative.
Deve essere trascinabile solo il percorso principale. Gli utenti possono trascinare il percorso principale finché non corrisponde a un percorso alternativo.
Indicazioni stradali geocodificate
Un DirectionsGeocodedWaypoint
contiene dettagli sulla geocodifica di
origine, destinazione e tappe.
DirectionsGeocodedWaypoint
è un valore letterale di oggetto con i seguenti campi:
geocoder_status
indica il codice di stato risultante dall'operazione di geocodifica. Questo campo può contenere i seguenti valori."OK"
indica che non si sono verificati errori; l'indirizzo è stato analizzato correttamente e almeno un codice geografico è stato restituito."ZERO_RESULTS"
indica che il codice geografico è riuscito, ma non ha restituito risultati. Ciò può accadere se al geocodificatore viene trasmesso un elementoaddress
inesistente.
-
partial_match
indica che il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è riuscita a far corrispondere parte dell'indirizzo richiesto. Ti consigliamo di esaminare la richiesta originale per verificare l'eventuale presenza di errori ortografici e/o un indirizzo incompleto.Nella maggior parte dei casi, le corrispondenze parziali si verificano per gli indirizzi che non esistono nella località trasmessa nella richiesta. Le corrispondenze parziali possono essere restituite anche quando una richiesta corrisponde a due o più sedi nella stessa località. Ad esempio, "Hillpar St, Bristol, Regno Unito" restituirà una corrispondenza parziale sia per Henri Street che per Henrietta Street. Tieni presente che se una richiesta include un componente dell'indirizzo con errori ortografici, il servizio di geocodifica potrebbe suggerire un indirizzo alternativo. Anche i suggerimenti attivati in questo modo verranno contrassegnati come parziali.
place_id
è un identificatore univoco di un luogo, che può essere utilizzato con altre API di Google. Ad esempio, potete utilizzareplace_id
con la libreria Google Places API per ricevere dettagli su un'attività locale, come numero di telefono, orario di apertura, recensioni degli utenti e altro ancora. Consulta la panoramica sull'ID luogo.types[]
è un array che indica il tipo del risultato restituito. Questo array contiene un insieme di zero o più tag che identificano il tipo di funzionalità restituita nel risultato. Ad esempio, un codice geografico di "Chicago" restituisce "città" che indica che "Chicago" è una città e restituisce anche "politica" che indica che si tratta di un'entità politica.
Indicazioni stradali Route
Nota: l'oggetto DirectionsTrip
legacy è stato
rinominato DirectionsRoute
. Nota che ora una route si riferisce all'intero percorso dall'inizio alla fine, anziché limitarsi a una tratta del percorso principale.
DirectionsRoute
contiene un singolo risultato proveniente dall'origine e dalla destinazione specificate. Questa route può essere composta da
una o più tappe (di tipo DirectionsLeg
)
a seconda che siano stati specificati dei tappe. Inoltre, il percorso contiene anche informazioni sul copyright e sull'avviso che devono essere mostrate all'utente oltre alle informazioni di routing.
DirectionsRoute
è un valore letterale di oggetto con i seguenti campi:
legs[]
contiene un array di oggettiDirectionsLeg
, ognuno dei quali contiene informazioni su una tratta del percorso da due posizioni all'interno della route specificata. Sarà presente una gamba separata per ogni waypoint o destinazione specificato. (Una route senza waypoint conterrà esattamente unDirectionsLeg
.) Ogni tratta è composta da una serie diDirectionStep
.waypoint_order
contiene un array che indica l'ordine di tutti i tappe nella route calcolata. Questo array potrebbe contenere un ordine alterato seDirectionsRequest
ha superatooptimizeWaypoints: true
.overview_path
contiene un array diLatLng
che rappresentano un percorso approssimativo (attenuato) delle indicazioni stradali risultanti.overview_polyline
contiene un singolo oggettopoints
che contiene una rappresentazione polilinea della route. Questa polilinea è un percorso approssimativo (attenuato) delle indicazioni stradali risultanti.bounds
contiene unLatLngBounds
che indica i limiti della polilinea lungo questo percorso.copyrights
contiene il testo relativo al copyright da mostrare per questo percorso.warnings[]
contiene un array di avvisi da visualizzare quando vengono mostrate queste indicazioni stradali. Se non utilizzi l'oggettoDirectionsRenderer
fornito, devi gestire e visualizzare personalmente questi avvisi.fare
contiene la tariffa totale (ovvero i costi totali del biglietto) per questo itinerario. Questa proprietà viene restituita solo per le richieste di trasporto pubblico e solo per i percorsi in cui sono disponibili informazioni sulle tariffe per tutte le fermate del trasporto pubblico. Tali informazioni includono:currency
: un codice valuta ISO 4217 che indica la valuta in cui è espresso l'importo.value
: l'importo totale della tariffa, nella valuta specificata sopra.
Indicazioni stradali
Nota: l'oggetto DirectionsRoute
legacy è stato
rinominato DirectionsLeg
.
Un DirectionsLeg
definisce una singola tratta di un percorso dall'origine alla destinazione nella route calcolata.
Per le rotte che non contengono tappe, la route sarà costituita da una "linea", ma per le route che definiscono uno o più tappe, la route sarà costituita da una o più tratte, corrispondenti ai tratti specifici del percorso.
DirectionsLeg
è un valore letterale di oggetto con i
seguenti campi:
steps[]
contiene un array di oggettiDirectionsStep
che indicano le informazioni su ogni passaggio separato della tratta.distance
indica la distanza totale coperta da questa gamba, come oggettoDistance
nel seguente formato:value
indica la distanza in metritext
contiene una rappresentazione stringa della distanza, che per impostazione predefinita viene visualizzata in unità utilizzate all'origine. Ad esempio, le miglia verranno utilizzate per qualsiasi origine all'interno degli Stati Uniti. Puoi eseguire l'override di questo sistema unitario impostando un elementoUnitSystem
nella query originale. Tieni presente che, indipendentemente dal sistema di unità utilizzato, il campodistance.value
contiene sempre un valore espresso in metri.
Questi campi potrebbero non essere definiti se la distanza è sconosciuta.
duration
indica la durata totale di questa gamba, come oggettoDuration
nel seguente formato:value
indica la durata in secondi.text
contiene una rappresentazione stringa della durata.
Questi campi potrebbero non essere definiti se la durata è sconosciuta.
duration_in_traffic
indica la durata totale di questa tratta, tenendo conto delle condizioni correnti del traffico.duration_in_traffic
viene restituito solo se tutte le seguenti condizioni sono soddisfatte:- La richiesta non include i tappe per la sosta. Vale a dire che non includono i tappe in cui
stopover
ètrue
. - La richiesta riguarda unicamente indicazioni stradali: il
mode
è impostato sudriving
. departureTime
è incluso nel campodrivingOptions
della richiesta.- Sono disponibili condizioni di traffico per il percorso richiesto.
duration_in_traffic
contiene i seguenti campi:value
indica la durata in secondi.text
contiene una rappresentazione leggibile della durata.
- La richiesta non include i tappe per la sosta. Vale a dire che non includono i tappe in cui
arrival_time
contiene l'orario di arrivo previsto per questa tratta. Questa proprietà viene restituita solo per le indicazioni stradali di trasporto pubblico. Il risultato viene restituito come oggettoTime
con tre proprietà:value
il tempo specificato come oggettoDate
JavaScript.text
il tempo specificato come stringa. L'ora viene visualizzata nel fuso orario della fermata del trasporto pubblico.time_zone
contiene il fuso orario di questa stazione. Il valore è il nome del fuso orario come definito nel IANA Time Zone Database, ad esempio "America/New_York".
departure_time
contiene l'orario di partenza stimato per questa tratta, specificato come oggettoTime
.departure_time
è disponibile solo per le indicazioni stradali del trasporto pubblico.start_location
contiene ilLatLng
dell'origine di questa gamba. Poiché il servizio web Directions calcola le indicazioni stradali tra località utilizzando l'opzione di trasporto più vicina (di solito una strada) nei punti di partenza e di arrivo,start_location
potrebbe essere diverso dall'origine fornita da questa tratta se, ad esempio, una strada non è vicina all'origine.end_location
contiene ilLatLng
della destinazione di questa gamba. PoichéDirectionsService
calcola le indicazioni stradali tra le località utilizzando l'opzione di trasporto più vicina (di solito una strada) nei punti di partenza e di arrivo,end_location
potrebbe essere diverso dalla destinazione fornita da questa tratta se, ad esempio, una strada non è vicino alla destinazione.start_address
contiene l'indirizzo leggibile (in genere un indirizzo civico) all'inizio di questa tratta.
Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo in modo programmatico.end_address
contiene l'indirizzo leggibile (in genere un indirizzo stradale) della fine di questa gamba.
Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo in modo programmatico.
Indicazioni stradali
Un DirectionsStep
è l'unità più atomica del percorso di una direzione, contiene un singolo passaggio che descrive una specifica istruzione singola sul percorso. Ad es. "Sulla sinistra a W. Via Roma, 12" Il passaggio non descrive solo l'istruzione, ma contiene anche le informazioni sulla distanza e sulla durata correlate al passaggio successivo.
Ad esempio, un passaggio indicato come "Unisci a I-80 Ovest" può contenere una
durata di "37 miglia" e "40 minuti", a indicare che il prossimo passaggio
è a 37 miglia/40 minuti da questo passaggio.
Quando utilizzi il servizio Directions per cercare le indicazioni di trasporto pubblico, la matrice di passaggi includerà informazioni specifiche sul trasporto pubblico aggiuntive sotto forma di un oggetto transit
. Se
le indicazioni stradali includono più modalità di trasporto, verranno fornite indicazioni
dettagliate per camminare o guidare in un array steps[]
.
Ad esempio, un passaggio a piedi includerà le indicazioni stradali dalle posizioni di inizio e fine: "Cammina fino a Innes Ave & Fitch St". Il passaggio includerà indicazioni stradali dettagliate per quel percorso nell'array di steps[]
, ad esempio: "Procedi verso nord-ovest", "Svolgi a sinistra su Arelious Walker" e
"Sulla sinistra su Innes Ave".
DirectionsStep
è un valore letterale di oggetto con i
seguenti campi:
instructions
contiene le istruzioni per questo passaggio in una stringa di testo.distance
contiene la distanza percorsa da questo passaggio fino al passaggio successivo, come oggettoDistance
. (vedi la descrizione inDirectionsLeg
sopra). Questo campo potrebbe non essere definito se la distanza è sconosciuta.duration
contiene una stima del tempo necessario per eseguire il passaggio, fino al passaggio successivo, come oggettoDuration
. (vedi la descrizione inDirectionsLeg
sopra). Questo campo potrebbe non essere definito se la durata è sconosciuta.start_location
contiene ilLatLng
geocodificato del punto di partenza di questo passaggio.end_location
contiene ilLatLng
del punto finale di questo passaggio.polyline
contiene un singolo oggettopoints
che contiene una rappresentazione polilinea del passaggio. Questa polilinea è un percorso approssimativo del passaggio della gradina.steps[]
un valore letterale di un oggettoDirectionsStep
che contiene indicazioni dettagliate per camminare o guidare in indicazioni di trasporto pubblico. I passaggi secondari sono disponibili solo per le indicazioni stradali relative al trasporto pubblico.travel_mode
contiene l'oggettoTravelMode
utilizzato in questo passaggio. Le indicazioni per il trasporto pubblico possono includere una combinazione di indicazioni a piedi e di trasporto pubblico.path
contiene un array diLatLngs
che descrive il corso di questo passaggio.transit
contiene informazioni specifiche sul trasporto pubblico, come gli orari di arrivo e partenza, e il nome della linea di trasporto pubblico.
Informazioni specifiche sul trasporto pubblico
Le indicazioni per il trasporto pubblico restituiscono informazioni aggiuntive non pertinenti per altri mezzi di trasporto. Queste proprietà aggiuntive sono esposte
tramite l'oggetto TransitDetails
, restituito come proprietà di
DirectionsStep
. Dall'oggetto TransitDetails
puoi accedere a informazioni aggiuntive per gli oggetti TransitStop
, TransitLine
, TransitAgency
e VehicleType
come descritto di seguito.
Dettagli trasporto pubblico
L'oggetto TransitDetails
espone le seguenti proprietà:
arrival_stop
contiene un oggettoTransitStop
che rappresenta la stazione/la fermata di arrivo con le seguenti proprietà:name
il nome della fermata/della fermata del trasporto pubblico. Ad esempio: "Quadrato dell'Unione".location
la località della stazione/fermata, rappresentata daLatLng
.
departure_stop
contiene un oggettoTransitStop
che rappresenta la stazione di partenza/fermata.arrival_time
contiene l'ora di arrivo, specificata come oggettoTime
con tre proprietà:value
il tempo specificato come oggettoDate
JavaScript.text
il tempo specificato come stringa. L'ora viene visualizzata nel fuso orario della fermata del trasporto pubblico.time_zone
contiene il fuso orario di questa stazione. Il valore è il nome del fuso orario come definito nel IANA Time Zone Database, ad esempio "America/New_York".
departure_time
contiene l'orario di partenza, specificato come oggettoTime
.headsign
specifica la direzione da percorrere su questa linea, in quanto è contrassegnata sul veicolo o alla fermata di partenza. Spesso sarà la stazione capolinea.headway
, se disponibile, specifica il numero previsto di secondi tra le partenze dalla stessa fermata in questo momento. Ad esempio, con un valoreheadway
di 600, puoi aspettarti un'attesa di dieci minuti se perdi l'autobus.line
contiene un valore letterale dell'oggettoTransitLine
contenente le informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio.TransitLine
fornisce il nome e l'operatore della riga, insieme ad altre proprietà descritte nella documentazione di riferimento diTransitLine
.num_stops
contiene il numero di fermate in questo passaggio. Include la fermata di arrivo, ma non la fermata di partenza. Ad esempio, se le indicazioni stradali includono la fermata A, le fermate B e C e l'arrivo alla fermata D,num_stops
restituisce 3.
Linea di trasporto pubblico
L'oggetto TransitLine
espone le seguenti proprietà:
name
contiene il nome completo di questa linea di trasporto pubblico. "Via Verdi 7" o "Via Verdi 14".short_name
contiene il nome breve di questa linea di trasporto pubblico. In genere è un numero di riga, ad esempio "2" o "M14".agencies
è un array contenente un singolo oggettoTransitAgency
. L'oggettoTransitAgency
fornisce informazioni sull'operatore di questa riga, incluse le seguenti proprietà:name
contiene il nome dell'azienda di trasporto pubblico.phone
contiene il numero di telefono dell'azienda di trasporto pubblico.url
contiene l'URL dell'azienda di trasporto pubblico.
Nota: se esegui il rendering manuale delle indicazioni per il trasporto pubblico invece di utilizzare l'oggetto
DirectionsRenderer
, devi visualizzare i nomi e gli URL delle aziende di trasporto pubblico che gestiscono i risultati della corsa.url
contiene un URL per questa linea di trasporto pubblico come fornito dall'azienda di trasporto pubblico.icon
contiene un URL per l'icona associata a questa riga. La maggior parte delle città utilizza icone generiche che variano in base al tipo di veicolo. Alcune linee di trasporto pubblico, come il sistema della metropolitana di New York, hanno icone specifiche per la linea.color
contiene il colore di uso comune della segnaletica per questo trasporto pubblico. Il colore verrà specificato come stringa esadecimale, ad esempio #FF0033.text_color
contiene il colore del testo di uso comune per la segnaletica di questa riga. Il colore verrà specificato come stringa esadecimale.vehicle
contiene un oggettoVehicle
che include le seguenti proprietà:name
contiene il nome del veicolo su questa riga. Ad esempio: "Subway"type
contiene il tipo di veicolo utilizzato su questa linea. Consulta la documentazione relativa ai tipi di veicoli per un elenco completo dei valori supportati.icon
contiene un URL per l'icona comunemente associata a questo tipo di veicolo.local_icon
contiene l'URL dell'icona associata a questo tipo di veicolo, in base alla segnaletica di trasporto locale.
Tipo di veicolo
L'oggetto VehicleType
espone le seguenti proprietà:
Valore | Definizione |
---|---|
VehicleType.RAIL |
Ferrovia. |
VehicleType.METRO_RAIL |
Metropolitana leggera. |
VehicleType.SUBWAY |
Metropolitana leggera. |
VehicleType.TRAM |
Metropolitana leggera su terra. |
VehicleType.MONORAIL |
Monorotaia. |
VehicleType.HEAVY_RAIL |
Ferrovia pesante. |
VehicleType.COMMUTER_TRAIN |
Ferrovia per pendolari. |
VehicleType.HIGH_SPEED_TRAIN |
Treno ad alta velocità. |
VehicleType.BUS |
Autobus. |
VehicleType.INTERCITY_BUS |
Autolinee regionali e nazionali. |
VehicleType.TROLLEYBUS |
Tram. |
VehicleType.SHARE_TAXI |
Il taxi condiviso è un tipo di autobus che consente di scendere e prendere passeggeri ovunque lungo il percorso. |
VehicleType.FERRY |
Traghetto. |
VehicleType.CABLE_CAR |
Un veicolo che funziona su un cavo, solitamente a terra. Le funicolari per auto possono essere del tipo VehicleType.GONDOLA_LIFT . |
VehicleType.GONDOLA_LIFT |
Una funivia. |
VehicleType.FUNICULAR |
Un veicolo che sale su una ripida pendenza da un cavo. Una funicolare, di solito, è composta da due veicoli, ognuno dei quali funge da contrappeso per l'altra. |
VehicleType.OTHER |
Tutti gli altri veicoli restituiranno questo tipo. |
Ispezione di DirectionsResults
I componenti DirectionsResults
,
DirectionsRoute
, DirectionsLeg
, DirectionsStep
e TransitDetails
, possono essere ispezionati e utilizzati durante l'analisi di qualsiasi risposta di indicazioni stradali.
Importante: se esegui il rendering manuale delle indicazioni per il trasporto pubblico invece di utilizzare l'oggetto DirectionsRenderer
, devi visualizzare i nomi e gli URL delle aziende di trasporto pubblico che forniscono i risultati della corsa.
L'esempio seguente mostra le indicazioni a piedi per alcune attrazioni turistiche di New York. Analizziamo il DirectionsStep
della route per aggiungere indicatori per ogni passaggio e
alleghiamo un'informazione a un InfoWindow
con testo
didattico per quel passaggio.
Nota: poiché stiamo calcolando le indicazioni a piedi, mostriamo anche eventuali avvisi all'utente in un riquadro <div>
separato.
var map; var directionsRenderer; var directionsService; var stepDisplay; var markerArray = []; function initMap() { // Instantiate a directions service. directionsService = new google.maps.DirectionsService(); // Create a map and center it on Manhattan. var manhattan = new google.maps.LatLng(40.7711329, -73.9741874); var mapOptions = { zoom: 13, center: manhattan } map = new google.maps.Map(document.getElementById('map'), mapOptions); // Create a renderer for directions and bind it to the map. var rendererOptions = { map: map } directionsRenderer = new google.maps.DirectionsRenderer(rendererOptions) // Instantiate an info window to hold step text. stepDisplay = new google.maps.InfoWindow(); } function calcRoute() { // First, clear out any existing markerArray // from previous calculations. for (i = 0; i < markerArray.length; i++) { markerArray[i].setMap(null); } // Retrieve the start and end locations and create // a DirectionsRequest using WALKING directions. var start = document.getElementById('start').value; var end = document.getElementById('end').value; var request = { origin: start, destination: end, travelMode: 'WALKING' }; // Route the directions and pass the response to a // function to create markers for each step. directionsService.route(request, function(response, status) { if (status == "OK") { var warnings = document.getElementById("warnings_panel"); warnings.innerHTML = "" + response.routes[0].warnings + ""; directionsRenderer.setDirections(response); showSteps(response); } }); } function showSteps(directionResult) { // For each step, place a marker, and add the text to the marker's // info window. Also attach the marker to an array so we // can keep track of it and remove it when calculating new // routes. var myRoute = directionResult.routes[0].legs[0]; for (var i = 0; i < myRoute.steps.length; i++) { var marker = new google.maps.Marker({ position: myRoute.steps[i].start_point, map: map }); attachInstructionText(marker, myRoute.steps[i].instructions); markerArray[i] = marker; } } function attachInstructionText(marker, text) { google.maps.event.addListener(marker, 'click', function() { stepDisplay.setContent(text); stepDisplay.open(map, marker); }); }
Nel corpo HTML:
<div> <strong>Start: </strong> <select id="start"> <option value="penn station, new york, ny">Penn Station</option> <option value="grand central station, new york, ny">Grand Central Station</option> <option value="625 8th Avenue New York NY 10018">Port Authority Bus Terminal</option> <option value="staten island ferry terminal, new york, ny">Staten Island Ferry Terminal</option> <option value="101 E 125th Street, New York, NY">Harlem - 125th St Station</option> </select> <strong>End: </strong> <select id="end" onchange="calcRoute();"> <option value="260 Broadway New York NY 10007">City Hall</option> <option value="W 49th St & 5th Ave, New York, NY 10020">Rockefeller Center</option> <option value="moma, New York, NY">MOMA</option> <option value="350 5th Ave, New York, NY, 10118">Empire State Building</option> <option value="253 West 125th Street, New York, NY">Apollo Theatre</option> <option value="1 Wall St, New York, NY">Wall St</option> </select> <div>
Utilizzo dei Waypoint nei percorsi
Come indicato in DirectionsRequest,
puoi anche specificare i waypoint
(di tipo DirectionsWaypoint
) per il calcolo
dei percorsi per le indicazioni a piedi, in bicicletta o in auto. I tappe non sono disponibili per le indicazioni stradali del trasporto pubblico.
I tappe consentono di calcolare i percorsi tramite posizioni aggiuntive, nel qual caso il percorso restituito passa attraverso i punti specificati.
Un waypoint
è costituito dai seguenti campi:
location
(obbligatorio) specifica l'indirizzo del waypoint.stopover
(facoltativo) indica se questo punto di passaggio è una fermata effettiva della route (true
) o solo una preferenza per la route tramite la località indicata (false
). Gli scali sonotrue
per impostazione predefinita.
Per impostazione predefinita, il servizio Directions calcola un percorso attraverso i
waypoint forniti nell'ordine specificato. Facoltativamente, puoi passare optimizeWaypoints: true
all'interno di
DirectionsRequest
per consentire al servizio Directions di ottimizzare la route riorganizzata riorganizzando i tappe in un ordine più efficiente. Questa ottimizzazione è un'applicazione del
problema del commerciale. La durata del viaggio è il fattore principale che viene ottimizzato, ma altri fattori come la distanza, il numero di svolte e molto altro possono essere presi in considerazione per decidere quale sia il percorso più efficiente. Tutti i
tappe devono essere fermate per consentire al servizio Directions di ottimizzare il
proprio percorso.
Se indichi al servizio Directions di ottimizzare l'ordine dei suoi Waypoint, questo verrà restituito nel campo waypoint_order
all'interno dell'oggetto DirectionsResult
.
L'esempio seguente calcola le route per più paesi negli Stati Uniti utilizzando una serie di punti di partenza, punti di arrivo e tappe. Per selezionare più tappe, premi Ctrl + clic quando selezioni gli elementi nell'elenco.
Tieni presente che esaminiamo routes.start_address
e routes.end_address
per fornire il testo per i punti di partenza e di arrivo di ciascun percorso.
TypeScript
function initMap(): void { const directionsService = new google.maps.DirectionsService(); const directionsRenderer = new google.maps.DirectionsRenderer(); const map = new google.maps.Map( document.getElementById("map") as HTMLElement, { zoom: 6, center: { lat: 41.85, lng: -87.65 }, } ); directionsRenderer.setMap(map); (document.getElementById("submit") as HTMLElement).addEventListener( "click", () => { calculateAndDisplayRoute(directionsService, directionsRenderer); } ); } function calculateAndDisplayRoute( directionsService: google.maps.DirectionsService, directionsRenderer: google.maps.DirectionsRenderer ) { const waypts: google.maps.DirectionsWaypoint[] = []; const checkboxArray = document.getElementById( "waypoints" ) as HTMLSelectElement; for (let i = 0; i < checkboxArray.length; i++) { if (checkboxArray.options[i].selected) { waypts.push({ location: (checkboxArray[i] as HTMLOptionElement).value, stopover: true, }); } } directionsService .route({ origin: (document.getElementById("start") as HTMLInputElement).value, destination: (document.getElementById("end") as HTMLInputElement).value, waypoints: waypts, optimizeWaypoints: true, travelMode: google.maps.TravelMode.DRIVING, }) .then((response) => { directionsRenderer.setDirections(response); const route = response.routes[0]; const summaryPanel = document.getElementById( "directions-panel" ) as HTMLElement; summaryPanel.innerHTML = ""; // For each route, display summary information. for (let i = 0; i < route.legs.length; i++) { const routeSegment = i + 1; summaryPanel.innerHTML += "<b>Route Segment: " + routeSegment + "</b><br>"; summaryPanel.innerHTML += route.legs[i].start_address + " to "; summaryPanel.innerHTML += route.legs[i].end_address + "<br>"; summaryPanel.innerHTML += route.legs[i].distance!.text + "<br><br>"; } }) .catch((e) => window.alert("Directions request failed due to " + status)); } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
JavaScript
function initMap() { const directionsService = new google.maps.DirectionsService(); const directionsRenderer = new google.maps.DirectionsRenderer(); const map = new google.maps.Map(document.getElementById("map"), { zoom: 6, center: { lat: 41.85, lng: -87.65 }, }); directionsRenderer.setMap(map); document.getElementById("submit").addEventListener("click", () => { calculateAndDisplayRoute(directionsService, directionsRenderer); }); } function calculateAndDisplayRoute(directionsService, directionsRenderer) { const waypts = []; const checkboxArray = document.getElementById("waypoints"); for (let i = 0; i < checkboxArray.length; i++) { if (checkboxArray.options[i].selected) { waypts.push({ location: checkboxArray[i].value, stopover: true, }); } } directionsService .route({ origin: document.getElementById("start").value, destination: document.getElementById("end").value, waypoints: waypts, optimizeWaypoints: true, travelMode: google.maps.TravelMode.DRIVING, }) .then((response) => { directionsRenderer.setDirections(response); const route = response.routes[0]; const summaryPanel = document.getElementById("directions-panel"); summaryPanel.innerHTML = ""; // For each route, display summary information. for (let i = 0; i < route.legs.length; i++) { const routeSegment = i + 1; summaryPanel.innerHTML += "<b>Route Segment: " + routeSegment + "</b><br>"; summaryPanel.innerHTML += route.legs[i].start_address + " to "; summaryPanel.innerHTML += route.legs[i].end_address + "<br>"; summaryPanel.innerHTML += route.legs[i].distance.text + "<br><br>"; } }) .catch((e) => window.alert("Directions request failed due to " + status)); } window.initMap = initMap;
Limiti e restrizioni per i Waypoint
Si applicano i limiti e le limitazioni di utilizzo seguenti:
- Il numero massimo di tappe consentito quando si utilizza il servizio Directions nell'API Maps JavaScript è 25, oltre all'origine e alla destinazione. I limiti sono gli stessi per il servizio web dell'API Directions.
- Per il servizio web dell'API Directions sono consentiti 25 tappe, oltre all'origine e alla destinazione.
- Ai clienti di Google Maps Platform Premium Plan sono consentiti 25 tappe, oltre all'origine e alla destinazione.
- I Waypoint non sono supportati per le indicazioni stradali di trasporto pubblico.
Indicazioni trascinabili
Gli utenti possono modificare in modo dinamico le indicazioni stradali per le biciclette, a piedi o in auto visualizzate utilizzando un
DirectionsRenderer
se sono trascinabili, consentendo a un utente di selezionare e modificare i percorsi
facendo clic e trascinando i percorsi risultanti sulla mappa.
Puoi indicare se il display di un renderer consente indicazioni stradali trascinabili impostando la relativa proprietà draggable
su true
. Le indicazioni per il trasporto pubblico non possono essere trascinate.
Se le indicazioni stradali sono trascinabili, un utente può selezionare un punto qualsiasi del percorso (o del waypoint) del risultato visualizzato e spostare il componente indicato in una nuova posizione. DirectionsRenderer
si aggiornerà dinamicamente per mostrare il percorso modificato. Al momento del lancio, verrà aggiunto alla mappa un punto di transizione transitorio (indicato da un piccolo indicatore bianco). La selezione e lo spostamento di un tratto di percorso
modificheranno quella parte del percorso, mentre la selezione e lo spostamento
di un indicatore dei punti di arrivo (inclusi i punti di partenza e di arrivo) modificherà
le parti del percorso che attraversano tale punto.
Poiché le direzioni trascinabili vengono modificate e visualizzate sul lato client, ti consigliamo di monitorare e gestire l'evento directions_changed
su DirectionsRenderer
per ricevere una notifica quando l'utente ha modificato le indicazioni stradali visualizzate.
Il codice seguente mostra un viaggio da Perth sulla costa occidentale dell'Australia
a Sydney, sulla costa orientale. Il codice monitora l'evento directions_changed
per aggiornare la distanza totale di tutte le tratte del percorso.
TypeScript
function initMap(): void { const map = new google.maps.Map( document.getElementById("map") as HTMLElement, { zoom: 4, center: { lat: -24.345, lng: 134.46 }, // Australia. } ); const directionsService = new google.maps.DirectionsService(); const directionsRenderer = new google.maps.DirectionsRenderer({ draggable: true, map, panel: document.getElementById("panel") as HTMLElement, }); directionsRenderer.addListener("directions_changed", () => { const directions = directionsRenderer.getDirections(); if (directions) { computeTotalDistance(directions); } }); displayRoute( "Perth, WA", "Sydney, NSW", directionsService, directionsRenderer ); } function displayRoute( origin: string, destination: string, service: google.maps.DirectionsService, display: google.maps.DirectionsRenderer ) { service .route({ origin: origin, destination: destination, waypoints: [ { location: "Adelaide, SA" }, { location: "Broken Hill, NSW" }, ], travelMode: google.maps.TravelMode.DRIVING, avoidTolls: true, }) .then((result: google.maps.DirectionsResult) => { display.setDirections(result); }) .catch((e) => { alert("Could not display directions due to: " + e); }); } function computeTotalDistance(result: google.maps.DirectionsResult) { let total = 0; const myroute = result.routes[0]; if (!myroute) { return; } for (let i = 0; i < myroute.legs.length; i++) { total += myroute.legs[i]!.distance!.value; } total = total / 1000; (document.getElementById("total") as HTMLElement).innerHTML = total + " km"; } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
JavaScript
function initMap() { const map = new google.maps.Map(document.getElementById("map"), { zoom: 4, center: { lat: -24.345, lng: 134.46 }, // Australia. }); const directionsService = new google.maps.DirectionsService(); const directionsRenderer = new google.maps.DirectionsRenderer({ draggable: true, map, panel: document.getElementById("panel"), }); directionsRenderer.addListener("directions_changed", () => { const directions = directionsRenderer.getDirections(); if (directions) { computeTotalDistance(directions); } }); displayRoute( "Perth, WA", "Sydney, NSW", directionsService, directionsRenderer ); } function displayRoute(origin, destination, service, display) { service .route({ origin: origin, destination: destination, waypoints: [ { location: "Adelaide, SA" }, { location: "Broken Hill, NSW" }, ], travelMode: google.maps.TravelMode.DRIVING, avoidTolls: true, }) .then((result) => { display.setDirections(result); }) .catch((e) => { alert("Could not display directions due to: " + e); }); } function computeTotalDistance(result) { let total = 0; const myroute = result.routes[0]; if (!myroute) { return; } for (let i = 0; i < myroute.legs.length; i++) { total += myroute.legs[i].distance.value; } total = total / 1000; document.getElementById("total").innerHTML = total + " km"; } window.initMap = initMap;