L'SDK di navigazione è attualmente disponibile solo per clienti selezionati. Per scoprire di più, contatta il team di vendita.

A breve su Google Maps Platform saranno disponibili nuovi stili di mappa. Questo aggiornamento dello stile della mappa include una nuova tavolozza dei colori predefinita e miglioramenti all'usabilità e alle esperienze delle mappe. Tutti gli stili di mappa verranno aggiornati automaticamente a marzo 2025. Per ulteriori informazioni sulla disponibilità e su come attivare la funzionalità in precedenza, consulta la sezione Nuovo stile di mappa per Google Maps Platform.

Questa pagina è stata tradotta dall'API Cloud Translation.

Domande frequenti

Dettagli del prodotto

Come deve essere mostrata l'informativa sui Termini di servizio dell'SDK di navigazione?: La tua app deve implementare una finestra di dialogo con la notifica relativa ai Termini di servizio dell'SDK Navigation che ogni utente deve accettare. Questa finestra di dialogo offre all'utente la possibilità di accettare i Termini di servizio. Un file di testo dei termini è fornito con l'SDK Navigation. Usa NavigationApi.showTermsAndConditionsDialog per visualizzare la finestra di dialogo contenente i termini.
Quali lingue sono supportate dalla guida vocale?: Tutte le lingue supportate da Google Maps Mobile vengono automaticamente disponibili per l'SDK di navigazione. Un dispositivo ha una lingua di sistema predefinita e un'app non può modificare questa impostazione. ma l'app ha accesso a oltre 70 lingue.
L'orientamento viene mantenuto quando l'utente esce dalla modalità di navigazione?: Sì. Una volta avviato, LocationListener continua a eseguire in background. L'app continua ad agganciarsi alla posizione e mantiene l'orientamento.
Le polilinee sono disponibili quando inizi o modifichi un percorso?: Sì. Quando un percorso viene creato o modificato, RouteChangeListener fornisce polilinee.
Gli utenti dell'app devono aver installato Google Maps Mobile?: No, l'SDK di navigazione non richiede Google Maps Mobile da installare sul dispositivo.
L'SDK di navigazione riesce a identificare i parcheggi nelle vicinanze di ristoranti? e altri punti d'interesse?: No, l'SDK di navigazione non fornisce questa funzionalità al momento nel tempo.
L'SDK di navigazione mostra la direzione del traffico nelle corsie. quando ci si avvicina a una svolta?: Sì. La direzione del traffico è disponibile e visualizzata per impostazione predefinita.
Quali versioni del JDK sono supportate dall'SDK di navigazione?: L'SDK di navigazione supporta le versioni LTS di Java SE supportate attivamente da Oracle. Queste versioni sono indicate come dotate di assistenza Premier nella Roadmap dell'assistenza Oracle Java SE.

Rete e connettività

In che modo l'SDK Navigation gestisce una scarsa connettività di rete?

L'SDK di navigazione prememorizza il percorso per ogni viaggio. Le informazioni prememorizzate nella cache includono informazioni di routing per 15-20 minuti, e percorsi alternative nel caso in cui l'utente si discosti dal percorso. L'SDK Navigation approssima la posizione utilizzando il GPS e i sensori del dispositivo.

In che modo l'SDK di navigazione gestisce i segnali GPS scarsi o persi?

Dopo l'avvio della navigazione e l'SDK di navigazione riceve Segnale GPS almeno una volta, verrà visualizzato il messaggio "Ricerca GPS in corso..." messaggio nelle seguenti situazioni:

Se sono trascorsi più di 10 secondi dall'ultima volta che ha ricevuto un segnale GPS.
Se la posizione del percorso si è spostata di più di 500 m dall'ultima volta che ha ricevuto un segnale GPS.

Se l'SDK non riceve il segnale GPS per un lungo periodo di tempo, l'avanzamento lungo il percorso, indicato nell'app dalla posizione dello chevron, può rallentare fino all'arresto completo. In questo caso, lo chevron sulla mappa rimarrà nella posizione indicata dall'ultimo segnale GPS. L'SDK non uscirà automaticamente dalla modalità di navigazione se non ricevi un segnale GPS. Tuttavia, potrebbe non essere in grado di fornire indicazioni finché non riceve di nuovo un segnale.

È disponibile una modalità offline?

No, l'SDK di navigazione non offre una modalità offline; Tuttavia, l'SDK fornisce informazioni pre-memorizzate nella cache per un viaggio.

Dati

Posso recuperare tutte le fermate/destinazioni di un viaggio prima di avviare il percorso?

Sì. Per recuperare le indicazioni stradali per un percorso, chiama Navigator.getRouteSegments().

Le indicazioni stradali passo passo sono disponibili all'inizio di un percorso?

Sì. L'SDK Navigation fornisce un elenco di segmenti di percorso. Inoltre, l'utente può scorrere la scheda delle indicazioni stradali nell'intestazione per vedere ogni manovra.

Come viene comunicata l'ora di arrivo stimata agli utenti dell'app?

Per fornire informazioni sull'orario di arrivo stimato agli utenti dell'app:

Recupera il tempo e la distanza per tutti i waypoint utilizzando Navigator.getTimeAndDistanceList().
Inoltra queste informazioni all'applicazione client come faresti per l'orario di arrivo stimato del conducente.

RoadSnappedLocationProvider può essere utilizzato per ottenere la risposta dell'utente posizione attuale agganciata se la navigazione non è in primo piano?

Sì. Il RoadSnappedLocationProvider viene eseguito sfondo per impostazione predefinita.

L'SDK di navigazione supporta il geofencing?

No. Nel contesto della navigazione, remainingTimeOrdistanceChangeListener ha un vantaggio su un recinto virtuale. Il recinto virtuale potrebbe non tenere conto e potrebbe non essere centrata sul punto esatto in cui mentre l'utente sta navigando.

Puoi approssimare questa funzionalità utilizzando remainingTimeOrdistanceChangeListener.

Imposta la soglia per determinare la frequenza dei callback.
Controlla la distanza rimanente per raggiungere la destinazione.

Ad esempio, se imposti la soglia su 100 m, ricevi una richiamata quando la distanza dalla destinazione cambia di 100 m. Man mano che la distanza diminuisce, puoi aggiornare questa soglia impostandola su un valore inferiore e ricevere callback più frequenti. Quindi, controlla la distanza rimanente determinare se sei abbastanza vicino al punto di partenza/arrivo.

Posso disattivare le notifiche quando l'app di navigazione è in background?

Sì. Usa Navigator.setHeadsUpNotificationEnabled per controllare le notifiche. Questo metodo ha un argomento booleano. FALSE disattiva le notifiche; TRUE attiva le notifiche.

Come faccio a visualizzare il log delle transazioni conservate da Google?

Il registratore delle transazioni monitora gli spostamenti e gli abbandoni con un ID univoco, che Google registra per l'analisi del prodotto. Se sei un cliente di Servizi per la mobilità, Google consiglia di implementare Da NavigationTransactionRecorder a registrare un record delle tue transazioni.

Personalizzazione dell'interfaccia utente

Posso assegnare un codice colore all'opzione di percorso migliore?

No. Al momento non è supportata la codifica a colori di un'opzione di percorso specifica.

L'SDK Navigation può mostrare l'orario di arrivo stimato per la destinazione finale?

Sì. Utilizza i seguenti metodi:

Recupera il tempo e la distanza per tutti i waypoint utilizzando Navigator.getTimeAndDistanceList().
Nascondi l'orario di arrivo stimato della tappa corrente utilizzando NavigationFragment.setEtaCardEnabled(false).
Mostra l'orario di arrivo stimato alla destinazione finale.

Come faccio a nascondere gli aggiornamenti sull'orario di arrivo stimato?

Puoi disattivare le schede dell'orario di arrivo stimato chiamando il numero navigationView.setEtaCardEnabled(false).

Quali personalizzazioni dell'interfaccia utente sono disponibili per le schede intestazione e piè di pagina?

Utilizza StylingOptions per impostare lo stile del colore dello sfondo. Per nascondere o mostrare l'intestazione e piè di pagina, usa i setHeaderEnabled e setFooterEnabled funzioni per i membri di NavigationFragment.

Routing

Posso fornire un percorso specifico a un utente o rimuovere percorsi alternativi?

No. Per impostazione predefinita, vengono forniti più percorsi e quello più veloce ha la priorità. Puoi modificare il percorso predefinito aggiungendo preferenze, come "evitare autostrade e pedaggi", alla tua richiesta. L'aggiunta di waypoint influisce anche sul percorso.

Posso mostrare all'utente dell'app un'etichetta diversa da quella predefinita per la destinazione località di destinazione?

Sì. Crea un Marker con un titolo personalizzato per la destinazione e la latitudine/longitudine. L'SDK Navigation mostra il titolo personalizzato e le coordinate su NavigationMap.

Posso utilizzare l'SDK Navigation per monitorare le deviazioni da un percorso definito?

Sì. Usa Navigator.setRouteChangedListener per ricevere notifiche quando un itinerario cambia o quando ne viene consigliato uno nuovo:

Registra un ascoltatore che controlla la posizione del dispositivo lungo il percorso utilizzando il metodo Navigator.setRouteChangedListener.
Aggiungi il codice al gestore dell'evento di callback onRouteChanged:
- Invia un messaggio all'utente dell'app con informazioni aggiornate su orario di arrivo stimato e distanza.
- Monitora la posizione del dispositivo.
- [Facoltativo] Aggiungi altre funzionalità richieste dalla tua app per gestire la situazione in cui l'utente non segue il percorso prescritto.

L'utente può uscire dalla navigazione senza completare il percorso?

Sì. Chiama il metodo Navigator.stopGuidance() per interrompi la navigazione.

Simulatore

Il simulatore supporta le modifiche al percorso?: Sì. Chiama simulateLocationsAlongNewRoute per simulare un viaggio che include una modifica del percorso. Il metodo simulateLocationsAlongExistingRoute ignora le modifiche al percorso esistente.

Workflows

Come faccio a ignorare la notifica dopo aver chiuso un'attività che contiene un frammento di navigazione?

La notifica di navigazione rimane visibile durante la navigazione, quando l'attività è chiusa. Quando il veicolo arriva alla destinazione, la navigazione si interrompe e la notifica scompare.

Per gestire i clic sulla notifica, utilizza Navigator.startGuidance(intent resumeIntent). L'evento resume intent si attiva quando l'utente dell'app fa clic sulla notifica. In genere, Navigator.startguidance(getIntent()) viene chiamato dalla sezione Attività principale, che richiama l'attività quando l'utente dell'app fa clic sulla notifica.

Servizi di mobilità

In che modo l'utilizzo dell'SDK per la navigazione è diverso per i clienti di Mobility Services?

I servizi di mobilità di Google Maps Platform offrono una raccolta di API e SDK per supportare le esigenze delle aziende di trasporto e logistica. Per i clienti di Mobility Services, l'SDK di navigazione viene in genere utilizzato insieme ai servizi correlati per l'ottimizzazione dei percorsi, la spedizione, il monitoraggio delle attività, l'analisi del parco risorse e altro ancora. Anche l'SDK di navigazione viene fatturato in modo diverso per i clienti di Servizi di mobilità. Per saperne di più, consulta la documentazione di Mobility Services.

I prodotti per la mobilità sono attualmente disponibili solo per alcuni clienti. Per saperne di più, contatta il tuo rappresentante di vendita.

Come faccio a sapere se sono un cliente di Mobility Services?

Se non sai con certezza se stai attualmente implementando l'SDK Navigation come cliente di Mobility Services, cerca una chiamata ReportBillableEvent nel codice. Solo i clienti di Mobility Services devono chiamare il metodo ReportBillableEvent.

Come viene fatturato l'SDK di navigazione per i clienti di Mobility Services?

Per i clienti di Mobility Services, la fatturazione e i prezzi dell'SDK Navigation dipendono dal contratto di servizio stipulato con Google Maps Platform. Per informazioni su come assicurarti che l'implementazione di Mobility Services venga fatturata correttamente, consulta la sezione Convalida della fatturazione. Per ulteriori informazioni sulla fatturazione di Mobility Services, contatta il tuo rappresentante di vendita.

Quali API SDK Navigation devono essere utilizzate solo dai clienti di Mobility Services?

Nell'SDK Navigation sono presenti diverse API destinate esclusivamente all'utilizzo da parte dei clienti di Mobility Services, a cui Google fattura su base transazionale. Se non sei un cliente di Servizi di mobilità, i seguenti metodi sono autonomi:

Se sono un cliente di Servizi di mobilità, posso utilizzare anche un'implementazione non di Servizi per la mobilità dell'SDK di navigazione?

Sì, i clienti dei Servizi di mobilità possono utilizzare le implementazioni dei servizi di mobilità e di altri servizi di navigazione dell'SDK di navigazione. Tuttavia, puoi utilizzare un solo tipo di implementazione in un'app alla volta. Devi inoltre creare un nuovo progetto Google Cloud, un nuovo account di fatturazione e una nuova chiave API, separati da quelli che utilizzi con l'implementazione dei Servizi di mobilità. Per ulteriori informazioni, consulta la panoramica della configurazione dell'SDK Navigation.

Per ulteriori informazioni sull'utilizzo di un'implementazione non mobile dell'SDK di navigazione, inclusa la migrazione di un'app da un tipo di implementazione all'altro, contatta il rappresentante Google per l'account.

Nota: se attualmente non sei un cliente di Mobility Services e ti interessa saperne di più sulla raccolta di API e SDK di Mobility Services, contatta il team di vendita di Google Maps Platform.