Domande frequenti

Dettagli del prodotto

Problemi

Rete

Dati

Personalizzazione della UI

Routing

Simulatore

Workflows

Servizi di mobilità

Dettagli del prodotto

La tua app deve implementare una finestra di dialogo con la nota dei Termini di servizio di Navigation SDK che ogni conducente deve accettare. Questa finestra di dialogo offre al conducente l'opportunità di accettare i Termini di servizio. Un file di testo dei termini viene fornito con l'SDK Navigation.
In Android, utilizza il metodo NavigationApi.showTermsAndConditionsDialog per visualizzare la finestra di dialogo contenente i termini.
In iOS, chiama GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName.
Tutte le lingue supportate da Google Maps Mobile sono 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.

Sì. In Android, una volta avviata, l'app LocationListener continua a essere eseguita in background. L'app continua ad agganciare la posizione alla strada e mantiene la direzione.

In iOS, per continuare a ricevere aggiornamenti della posizione e della direzione in background, implementa l'aggancio alla strada e imposta allowsBackgroundLocationUpdates su YES.

Sì. Quando un percorso viene creato o modificato, RouteChangeListener fornisce le polilinee.

No, l'SDK Navigation non richiede l'installazione di Google Maps Mobile sul dispositivo.
No, al momento l'SDK Navigation non fornisce questa funzionalità.
Sì. La direzione del traffico è disponibile e visualizzata per impostazione predefinita.

Problemi

In Xcode 12, le app non vengono create correttamente per il simulatore. Come faccio a risolvere il problema?

Per risolvere il problema, apri le impostazioni di build del progetto Xcode e aggiungi arm64 a Excluded Architectures solo per le build "iOS Simulator".

Per saperne di più, consulta il seguente thread di StackOverflow.

GMSMapView non si carica.

Se GMSMapView non si carica:

  • Verifica che NavSDK sia abilitato nella console Cloud.
  • Se l'SDK di navigazione è installato, ma il tuo progetto non utilizza le API dell'SDK di navigazione, rimuovilo dal file binario.

Rete

In che modo l'SDK Navigation gestisce la connettività scadente?
L'SDK Navigation pre-memorizza nella cache il percorso per ogni viaggio. Le informazioni pre-memorizzate nella cache includono informazioni sul percorso per 15-20 minuti e percorsi alternativi nel caso in cui il conducente devii dal percorso. Il Navigation SDK approssima la posizione utilizzando il GPS e i sensori del dispositivo.
È disponibile una modalità offline?
No, al momento l'SDK Navigation non offre una modalità offline, ma fornisce informazioni pre-memorizzate nella cache per un percorso.

Dati

Posso recuperare tutte le fermate/destinazioni di un percorso prima di iniziare il tragitto?

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

In iOS, chiama GMSNavigator.routeLegs(read).

Le indicazioni stradali passo passo sono disponibili all'inizio di un percorso?
Sì. Il Navigation SDK fornisce un elenco di segmenti di percorso. Inoltre, il conducente può scorrere la scheda delle indicazioni stradali nell'intestazione per visualizzare ogni manovra.
In che modo l'orario di arrivo stimato viene comunicato agli utenti dell'app?

In Android, segui questi passaggi per fornire informazioni sull'orario di arrivo stimato agli utenti dell'app:

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

In iOS, segui questi passaggi per fornire informazioni sull'orario di arrivo stimato agli utenti dell'app:

  1. Recupera le tappe del percorso utilizzando Navigator.getRouteSegments().
  2. Chiama GMSNavigator.timeToNextDestination per ogni tratta del percorso.
  3. Inoltra le informazioni sull'orario all'applicazione client come fai per l'orario di arrivo stimato del conducente.
È possibile utilizzare RoadSnappedLocationProvider per ottenere la posizione attuale del conducente se la navigazione non è in primo piano?

Sì. In Android, l'RoadSnappedLocationProvider viene eseguito in background per impostazione predefinita.

In iOS, per mantenere la navigazione in esecuzione in background, implementa il listener per GMSRoadSnappedLocationProviderListener e imposta la proprietà allowsBackgroundLocationUpdates su TRUE.

L'SDK Navigation supporta il geofencing?

No. Nel contesto della navigazione, remainingTimeOrdistanceChangeListener ha un vantaggio rispetto a un geofence. Il recinto virtuale potrebbe non tenere conto della geometria della strada e potrebbe non essere centrato sul punto esatto verso cui il conducente sta navigando.

Puoi approssimare questa funzionalità utilizzando remainingTimeOrdistanceChangeListener.

  1. Imposta la soglia per determinare la frequenza dei callback.
  2. Controlla la distanza rimanente dalla destinazione.

Ad esempio, se imposti la soglia su 100 m, ricevi un callback quando la distanza dalla destinazione cambia di 100 m. Man mano che la distanza diminuisce, puoi aggiornare questa soglia impostando un valore inferiore e ricevere callback più frequenti. Poi, controlla la distanza rimanente per determinare se sei abbastanza vicino al luogo di ritiro/consegna.

In iOS, implementa il listener GMSNavigatorListener.didUpdateRemainingDistance per gestire la distanza tra le notifiche.

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

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

In iOS, disattiva la notifica in background per le posizioni agganciate alla strada impostando GMSRoadSnappedLocationProvider.allowsBackgroundLocationUpdates su NO.

Per disattivare l'elaborazione in background per altre notifiche di posizione, chiama GMSNavigator.sendsBackgroundNotifications(NO).

Personalizzazione della UI

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ì. In Android, utilizza i seguenti metodi:

  1. Recupera il tempo e la distanza per tutti i waypoint utilizzando Navigator.getTimeAndDistanceList().
  2. Nascondi l'orario di arrivo stimato del waypoint corrente utilizzando NavigationFragment.setEtaCardEnabled(false).
  3. Esegui il rendering dell'orario di arrivo stimato della destinazione finale.

In iOS, utilizza quanto segue:

  1. Chiama il numero GMSNavigator.routeLegs(read).
  2. Con l'ultima tratta, chiama GMSNavigator.timeToNextDestination.
  3. Nascondi l'orario di arrivo stimato del waypoint corrente impostando MSMapView.settings.navigationFooterEnabled=NO su FALSE.
  4. Esegui il rendering dell'orario di arrivo stimato della destinazione finale.
Come faccio a nascondere gli aggiornamenti dell'orario di arrivo stimato?

Puoi disattivare le schede ETA con i seguenti metodi:

  • In Android, utilizza navigationView.setEtaCardEnabled(false).
  • In iOS, utilizza GMSMapView.settings.navigationFooterEnabled=NO.
Quali personalizzazioni della UI sono disponibili per le schede di intestazione e piè di pagina?

In Android, utilizzi StylingOptions per impostare lo stile del colore di sfondo. Per nascondere o mostrare l'intestazione e il piè di pagina, utilizza le funzioni membro setHeaderEnabled e setFooterEnabled di NavigationFragment.

In iOS, utilizza GMSMapView.settings.navigationHeaderPrimaryBackgroundColor per impostare lo stile del colore di sfondo. Per nascondere o mostrare l'intestazione e il piè di pagina, utilizza le proprietà navigationFooterEnabled e navigationHeaderEnabled di GMSUISettings.

Routing

Posso fornire un percorso specifico a un conducente 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, ad esempio "evita autostrade e pedaggi", alla tua richiesta. Anche l'aggiunta di tappe intermedie influisce sul percorso.
Posso mostrare all'utente dell'app un'etichetta per la destinazione diversa dalla località di destinazione predefinita?

Sì. In Android, crea un Marker con un titolo personalizzato per la destinazione e la latitudine/longitudine. Navigation SDK mostra il titolo personalizzato e le coordinate su NavigationMap.

In iOS, crei e visualizzi un GMSMarker per la destinazione.

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

Sì. In Android, utilizza Navigator.setRouteChangedListener per ricevere notifiche quando un percorso cambia o ne viene consigliato uno nuovo:

  1. Registra un listener che controlla la posizione del dispositivo lungo il percorso utilizzando il metodo Navigator.setRouteChangedListener.
  2. Aggiungi il codice al gestore di eventi di callback, onRouteChanged:
    • Invia un messaggio all'utente dell'app con informazioni aggiornate su orario di arrivo stimato e distanza.
    • Monitorare la posizione del dispositivo.
    • [Facoltativo] Aggiungi altre funzionalità richieste dalla tua app per gestire i casi in cui il conducente non segue il percorso prescritto.

In iOS, utilizza GMSNavigator e i relativi listener per ricevere notifiche quando un percorso cambia o ne viene consigliato uno nuovo:

  1. Nel controller di visualizzazione della mappa, implementa il protocollo GMSNavigatorListener e il protocollo GMSRoadSnappedLocationProviderListener.
  2. Implementa GMSNavigatorListener.navigatorDidChangeRoute.
  3. Accedi alla nuova route utilizzando le proprietà routeLegs e currentRouteLeg di GMSNavigator.
Il conducente può uscire dalla navigazione senza completare il percorso?

Sì. In Android, chiama il metodo Navigator.stopGuidance() per interrompere la navigazione.

In iOS, chiama GMSNavigator.clearDestinations.

L'SDK Navigation supporta il calcolo del percorso e la navigazione per camion e veicoli di grandi dimensioni?

Sì. Con il routing di veicoli di grandi dimensioni (LVR), puoi passare all'SDK Navigation i token di percorso specifici per i camion generati dall'API Routes o dall'API Route Optimization. L'SDK fornisce la navigazione passo passo con callout del percorso (altezza, peso, materiali pericolosi e limitazioni per i camion) e mantiene il profilo fisico del veicolo durante il cambio percorso dinamico. Per maggiori dettagli, consulta Naviga lungo i percorsi per veicoli di grandi dimensioni.

Simulatore

Il simulatore supporta le modifiche del percorso?

Sì. In Android, chiama simulateLocationsAlongNewRoute per simulare un percorso che include un cambio di itinerario. Il metodo simulateLocationsAlongExistingRoute ignora le modifiche al percorso esistente.

In iOS, utilizza GMSLocationSimulator.simulateAlongNewRouteToDestinations per simulare un percorso che include un cambio di percorso. Se non prevedi modifiche alle route, puoi utilizzare GMSLocationSimulator.simulateLocationsAlongExistingRoute o GMSLocationSimulator.simulateAlongNewRouteToDestinations.

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 a destinazione, la navigazione si interrompe e la notifica scompare.

Per gestire i clic sulla notifica, utilizza Navigator.startGuidance(intent resumeIntent). L'evento resume intent viene attivato quando l'utente dell'app fa clic sulla notifica. In genere, Navigator.startguidance(getIntent()) viene chiamato dall'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 Navigation è 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 aziendali delle attività di trasporto e logistica. Per i clienti dei servizi di mobilità, l'SDK di navigazione viene in genere utilizzato insieme ai servizi correlati per l'ottimizzazione dei percorsi, l'invio, il tracker delle attività, l'analisi della flotta e altro ancora. Anche l'SDK Navigation viene fatturato in modo diverso per i clienti di Mobility Services. Per saperne di più, consulta la documentazione relativa ai servizi di mobilità.

I prodotti di mobilità sono disponibili solo per clienti selezionati. Per ulteriori informazioni, contatta il tuo rappresentante di vendita.

Come faccio a sapere se sono un cliente di Mobility Services?
Se non sai se stai implementando l'SDK di navigazione 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 Navigation 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 verificare che la fatturazione dell'implementazione di Mobility Services sia corretta, consulta Convalida della fatturazione. Per ulteriori informazioni sulla fatturazione di Mobility Services, contatta il tuo rappresentante di vendita.

Quali API dell'SDK di navigazione devono essere utilizzate solo dai clienti di Mobility Services?

Nell'SDK di navigazione sono presenti diverse API destinate esclusivamente ai clienti di Mobility Services, ai quali Google fattura in base alle transazioni. Se non sei un cliente di Mobility Services, i seguenti metodi non sono operativi:

Se sono un cliente di Mobility Services, posso utilizzare anche un'implementazione dell'SDK Navigation non di Mobility Services?

Sì, i clienti di Mobility Services possono utilizzare sia le implementazioni di Mobility Services sia quelle non di Mobility Services del Navigation SDK. Tuttavia, puoi utilizzare un solo tipo di implementazione alla volta in un'app. Devi anche creare un nuovo progetto Google Cloud, un account di fatturazione e una chiave API, separati da quelli che utilizzi con l'implementazione di Mobility Services. Per saperne di più, consulta la panoramica della configurazione di Navigation SDK.

Per ulteriori informazioni sull'utilizzo di un'implementazione dell'SDK Navigation non basata su Mobility Services, inclusa la migrazione di un'app da un tipo di implementazione all'altro, contatta il tuo rappresentante Google per l'account.

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