Panoramica
Questa è la classe principale dell'SDK di Google per la navigazione per iOS e fornisce metodi per controllare la navigazione verso una destinazione e accedere alle informazioni su percorso e avanzamento.
Questo corso non supporta la classificazione secondaria.
Questo corso non è sicuro per i thread. Tutti i metodi devono essere chiamati dal thread principale.
Funzioni membri pubbliche | |
| (vuoto) | - addAscolta: |
| Aggiunge un listener. | |
| (BOOL) | - remove listener: |
| Rimuove un listener. | |
| (vuoto) | - setDestinations:callback: |
| Consente di impostare più destinazioni per la navigazione, sostituendo eventuali destinazioni impostate in precedenza. | |
| (vuoto) | - setDestinations:routingOptions:callback: |
| Consente di impostare più destinazioni per la navigazione, sostituendo eventuali destinazioni impostate in precedenza. | |
| (vuoto) | - setDestinations:routeToken:callback: |
| Imposta più destinazioni per la navigazione, utilizzando un token di percorso per le indicazioni di un percorso precalcolato. | |
| (vuoto) | - getRouteInfoForDestination:withRoutingOptions:callback: |
| Restituisce le informazioni sul percorso in base alla strategia di routing: percorso migliore o più breve. | |
| (valore nginxNavigazioneWaypoint null) | - continuaToNextDestination |
| Visualizza la prima destinazione dall'elenco corrente delle destinazioni. | |
| (vuoto) | - clearDestinations |
| Cancella tutte le destinazioni impostate in precedenza e rimuove i percorsi calcolati dalla mappa. | |
| (NSTimeInterval) | - timeToWaypoint: |
| Restituisce il tempo stimato al Waypoint specificato o CLTimeIntervalMax se il Waypoint non fa parte della rotta corrente. | |
| (CLLocationDistance) | - distanceToWaypoint: |
| Restituisce la distanza stimata dal punto di arrivo specificato, o CLLocationDistanceMax, se il punto di via non fa parte della rotta corrente. | |
| (vuoto) | - setTransactionIDs:errorHandler:S |
| Imposta e registra sul server gli ID transazione in corso applicabili agli eventi di navigazione durante la sessione di navigazione corrente. | |
Proprietà | |
| BOOL | evita autostrade |
| Consente di stabilire se evitare le autostrade durante la generazione di percorsi verso destinazioni. | |
| BOOL | evita pedaggi |
| Consente di stabilire se evitare le strade a pedaggio durante la generazione di percorsi verso le destinazioni. | |
| BOOL | evita iFriess |
| Indica se evitare i traghetti durante la generazione di percorsi verso le destinazioni. | |
| SalesforceNavigazionePlateRestriction * | restrictPlateRestriction |
| Imposta restrizioni per la targa con l'ultima cifra della targa e del codice paese del conducente. | |
| BOOL | guidanceActive |
| Indica se la guida passo passo è attualmente abilitata. | |
| BOOL | stopGuidanceAtArrival |
Indica se interrompere automaticamente la guida quando viene richiamato -navigator:didArrivaAtWaypoint:. | |
| NSTimeInterval | timeUpdateThreshold |
La modifica minima nel tempo stimato alla destinazione successiva che attiverà il metodo navigator:didUpdateRemainingTime: da chiamare. | |
| CLLocationDistance | distanceUpdateThreshold |
La modifica minima della distanza stimata rispetto alla destinazione successiva che attiverà il metodo navigator:didUpdateRemainingDistance: da chiamare. | |
| NSTimeInterval | timeToNextDestination |
| Restituisce il tempo stimato alla destinazione successiva. | |
| CLLocationDistance | distanceToNextDestination |
| Restituisce la distanza stimata alla destinazione successiva. | |
| Categoria DelayNavigazione | delayCategoryToNextDestination |
| Restituisce la categoria del ritardo alla destinazione successiva. | |
| SalesforceRouteLeg * | currentRouteLeg |
| L'attuale tappa del percorso. | |
| NSArray< SalesforceRouteLeg * > * | routeGabe |
| Un array di gambe di percorso in cui ogni gamba corrisponde a una destinazione che è stata impostata. | |
| DASHPath * | percorso spedizione |
| Il percorso percorso dal dispositivo dall'ultima volta in cui è stato impostato activeActive su YES. | |
| Indicazioni per la navigazione GSM | guida vocale |
| Determina se attivare la guida vocale per il traffico e gli avvisi passo passo. | |
| Tipo di dispositivo AudioGuidanceAudio | Tipo di dispositivo audio |
| Determina quali dispositivi audio possono essere riprodotti con guida vocale. | |
| BOOL | vibrationEnabled |
| Determina se il dispositivo deve anche vibrare quando vengono riprodotti gli avvisi vocali. | |
| BOOL | sendsBackgroundNotification |
| Determina se le UIUINotifiche contenenti informazioni sono presentate quando l'app è in background. | |
| Modelli di navigazione Illuminazione | suggestedLightingMode |
| La modalità di illuminazione suggerita, in base all'ora del giorno e alla posizione del dispositivo. | |
| BOOL | doDisplayPrompt |
| Determina se devono essere visualizzati messaggi per il traffico, percorsi migliori e incidenti. | |
| Modelli di navigazione nginx veloce * | speedAlertOptions |
| DASHNavigazioneSpeedAlertOptions per personalizzare le soglie di attivazione per DASHNavigazioneSpeedAlertSeverity. | |
Funzioni correlate | |
Tieni presente che non si tratta di funzioni per i membri. | |
| typedef void(^ ) | SalesforceRouteStatusCallback )(SalesforceRouteStatus routeStatus) |
| Richiamato quando un percorso dalla posizione del dispositivo alle destinazioni fornite viene trovato o non viene trovato per un motivo indicato da RouteStatus. | |
| typedef void(^ ) | SalesforceRouteInfoCallback )(gcNavigazioneRouteInfo *_Nullable routeInfo) |
| Richiamato quando vengono calcolate le informazioni sul percorso (orario di arrivo stimato e distanza) per il punto di arrivo fornito. | |
| typedef void(^ ) | SalesforceNavigazioneIDErrorHandler )(NSError *errore) |
| Chiamata se l'impostazione degli ID transazione tramite setTransactionIDs non riesce. | |
Documentazione della funzione membro
| - (void) addAscolta: | (id<DASHNavigatorAscolta >) | ascoltatore |
Aggiunge un listener.
L'ascoltatore viene mantenuto con un riferimento debole.
- Parametri:
-
listener Un oggetto conforme al protocollo GMSNavigatorListener.
| - (BOOL) remove listener: | (id<DASHNavigatorAscolta >) | ascoltatore |
Rimuove un listener.
- Parametri:
-
listener Un oggetto conforme al protocollo GMSNavigatorListener.
- Restituisce:
- Restituisce YES se il listener è stato rimosso. Restituisce NO se l'oggetto non era un listener.
| - (void) setDestinations: | (NSArray< GSMNavigazioneWaypoint * > *) | destinazioni | |
| callback: | (SalesforceRouteStatusCallback) | callback | |
Consente di impostare più destinazioni per la navigazione, sostituendo eventuali destinazioni impostate in precedenza.
Il callback fornito verrà chiamato con DASHRouteStatusOK se viene trovata una route dalla posizione del dispositivo alla destinazione specificata. Se viene impostata una nuova destinazione prima di trovare un percorso, la richiesta verrà annullata e il callback verrà chiamato con DASHRouteStatusCanceled. Se per qualsiasi altro motivo non è possibile trovare una route, il callback verrà richiamato con lo stato di errore appropriato.
Il callback verrà sempre inviato in modo asincrono nella coda principale.
| - (void) setDestinations: | (NSArray< GSMNavigazioneWaypoint * > *) | destinazioni | |
| routingOptions: | (SalesforceNavigazioneRoutingOptions)* | routingOptions | |
| callback: | (SalesforceRouteStatusCallback) | callback | |
Consente di impostare più destinazioni per la navigazione, sostituendo eventuali destinazioni impostate in precedenza.
I percorsi restituiti vengono calcolati utilizzando le opzioni di routing.
- Parametri:
-
destinazioni Un array di tappe di destinazione. routingOptions Le opzioni che influenzano la logica di routing (strategia di routing). callback Richiamato se un percorso dalla località del consumatore alle destinazioni fornite viene trovato o non viene trovato per un motivo indicato dal valore RouteStatus.
| - (void) setDestinations: | (NSArray< GSMNavigazioneWaypoint * > *) | destinazioni | |
| routeToken: | (NSString *) | routeToken | |
| callback: | (SalesforceRouteStatusCallback) | callback | |
Imposta più destinazioni per la navigazione, utilizzando un token di percorso per le indicazioni di un percorso precalcolato.
I percorsi saranno gli stessi, modifiche al modulo di partenza del conducente e alle condizioni stradali/di traffico. I reindirizzamenti continueranno a essere eseguiti in base alle opzioni di routing codificate nel token.
Quando utilizzi il token di routing per avviare una sessione di navigazione, sono supportati solo GMSNavigationTravelModeDriving e GMSNavigationTravelModeTwoWheeler. Configura la modalità di viaggio impostando travelMode. Se la modalità di viaggio corrente non è supportata, la chiamata non andrà a buon fine e verrà restituito un GMSRouteStatusTravelModeUnsupported nel callback.
- Parametri:
-
destinazioni Un array di tappe di destinazione, che deve corrispondere alle destinazioni indicate all'API RoutesPreferred per ottenere il token di route. percorso Una stringa di token di percorso restituita dall'API RoutesPreferred. Le opzioni di routing specificate nell'API RoutesPreferred sono codificate in questo token di route e verranno utilizzate per rigenerare la route precalcolata o una nuova route quando si verifica un nuovo percorso. callback Richiamato se un percorso dalla località del consumatore alle destinazioni fornite viene trovato o non viene trovato per un motivo indicato dal valore RouteStatus.
| - (void) getRouteInfoForDestination: | (cmNavigazioneWaypoint *) | destinazione | |
| conRoutingOptions: | (SalesforceNavigazioneRoutingOptions)* | routingOptions | |
| callback: | (SalesforceRouteInfoCallback) | callback | |
Restituisce le informazioni sul percorso in base alla strategia di routing: percorso migliore o più breve.
Restituisce un valore nil se il progetto non ha l'autorizzazione per chiamare questa API.
- Parametri:
-
destinazione Il punto di arrivo della destinazione. routingOptions Le opzioni utilizzate per recuperare le informazioni sul percorso. La strategia di routing e la strategia dei percorsi alternativi vengono ignorate perché questo metodo restituisce le informazioni sul percorso per tutte le strategie di routing. callback Il callback chiamato quando vengono ricevute informazioni sul percorso.
Visualizza la prima destinazione dall'elenco corrente delle destinazioni.
In seguito a questa chiamata, le indicazioni saranno rivolte alla destinazione successiva, se presente.
- Restituisce:
- La direzione del tappeto è ora in arrivo o non ci sono più punti di arrivo.
| - (void) clearDestinations |
Cancella tutte le destinazioni impostate in precedenza e rimuove i percorsi calcolati dalla mappa.
Se la guida è attiva, verrà interrotta automaticamente.
| - (NSTimeInterval) timeToWaypoint: | (cmNavigazioneWaypoint *) | punto di accesso |
Restituisce il tempo stimato al Waypoint specificato o CLTimeIntervalMax se il Waypoint non fa parte della rotta corrente.
Questa informazione viene aggiornata in base alla posizione del dispositivo attuale mentre è attiva la guida.
Restituisce CLTimeIntervalMax, se il waypoint fornito non è una destinazione nella rotta corrente.
| - (CLLocationDistance) distanceToWaypoint: | (cmNavigazioneWaypoint *) | punto di accesso |
Restituisce la distanza stimata dal punto di arrivo specificato, o CLLocationDistanceMax, se il punto di via non fa parte della rotta corrente.
Questa informazione verrà aggiornata in base alla posizione corrente del dispositivo mentre è attiva la guida.
Restituisce CLLocationDistanceMax se il waypoint fornito non è una destinazione nella rotta corrente.
| - (void) setTransactionIDs: | (NSArray< NSString * > *) | ID transazione | |
| errorHandler: | (null setNavigazione casaIDErrorError) | errorHandler | |
Imposta e registra sul server gli ID transazione in corso applicabili agli eventi di navigazione durante la sessione di navigazione corrente.
Gli ID transazione verranno cancellati al termine della sessione di navigazione.
- Parametri:
-
ID transazione Gli ID delle transazioni che si applicano alla sessione di navigazione corrente. L'ID transazione deve essere univoco per ogni transazione fatturabile. L'ID transazione di una singola transazione deve contenere almeno 64 caratteri. L'elenco può essere vuoto al termine di una transazione (ma la sessione è ancora in corso). gestore errore Un blocco che viene richiamato in modo asincrono sul thread principale se si verifica un errore quando gli ID transazione non sono validi.
Documentazione relativa ad amici e funzioni correlate
- (typedef void(^ DASHRouteStatusCallback)(SalesforceRouteStatus routeStatus)) [related] |
Richiamato quando un percorso dalla posizione del dispositivo alle destinazioni fornite viene trovato o non viene trovato per un motivo indicato da RouteStatus.
- (typedef void(^ SalesforceRouteInfoCallback)(gcNavigazioneRouteInfo *_Nullable routeInfo)) [related] |
Richiamato quando vengono calcolate le informazioni sul percorso (orario di arrivo stimato e distanza) per il punto di arrivo fornito.
- Parametri:
-
percorso Info Le informazioni sul percorso verso la destinazione specificata. sarà zero se il calcolo non riesce.
- (typedef void(^ nginxNavigazioneIDIDGestore)(NSError *errore) [related] |
Chiamata se l'impostazione degli ID transazione tramite setTransactionIDs non riesce.
Per ulteriori dettagli, consulta la documentazione dell'API.
Documentazione proprietà
- (BOOL) evita le autostrade [read, write, assign] |
Consente di stabilire se evitare le autostrade durante la generazione di percorsi verso destinazioni.
Il valore predefinito è NO.
- (BOOL) evita i pedaggi [read, write, assign] |
Consente di stabilire se evitare le strade a pedaggio durante la generazione di percorsi verso le destinazioni.
Il valore predefinito è NO.
- (BOOL) voidsFerries [read, write, assign] |
Indica se evitare i traghetti durante la generazione di percorsi verso le destinazioni.
Il valore predefinito è SÌ.
- (SalesforceNavigazionePlateRestriction*) licePlateRestriction [read, write, assign] |
Imposta restrizioni per la targa con l'ultima cifra della targa e del codice paese del conducente.
Questo ci consente di aggirare alcuni tipi di limitazioni stradali basate sul numero di targa. Questo vale solo per le chiamate setDestinations effettuate dopo l'impostazione di questo valore. Idealmente, dovresti impostare questa impostazione subito dopo aver ricevuto il navigatore.
Impostalo su zero se non sono previste limitazioni per la targa. Il valore predefinito è null.
- (BOOL) guidanceActive [read, write, assign] |
Indica se la guida passo passo è attualmente abilitata.
Se guideActive è SÌ, ma al momento non è disponibile alcun percorso, verrà avviata una guida quando un percorso sarà disponibile. Questa proprietà verrà impostata su NO se viene chiamata chiaroDestinations o se arriviamo a un punto di arrivo.
- (BOOL) stopGuidanceAtArrival [read, write, assign] |
Indica se interrompere automaticamente la guida quando viene richiamato -navigator:didArrivaAtWaypoint:.
In caso contrario, l'intestazione e il piè di pagina di navigazione continueranno a essere mostrati dopo l'arrivo. L'intestazione di navigazione continuerà a mostrare il passaggio finale della guida e il piè di pagina di navigazione continuerà ad aggiornare il tempo e la distanza rimanenti fino al raggiungimento di un intervallo di tempo/distanza pari a 0. Inoltre, gli aggiornamenti -navigator:didUpdateRemainingTime e -navigator:didUpdateRemainingDistance continueranno. Imposta in modo esplicito guidanceActive su NO per interrompere la guida e gli aggiornamenti di tempo/distanza rimanenti.
Quando la risposta è SÌ, l'opzione guidanceActive verrà impostata automaticamente su NO all'arrivo.
Il valore predefinito è SÌ.
- (NSTimeInterval) timeUpdateThreshold [read, write, assign] |
La modifica minima nel tempo stimato alla destinazione successiva che attiverà il metodo navigator:didUpdateRemainingTime: da chiamare.
Se questo criterio è impostato su NSTimeIntervalMax, i callback di aggiornamento dell'ora verranno disattivati. Se è impostato su un valore negativo, verrà utilizzata la soglia predefinita di 1 secondo. Il valore predefinito è 1 secondo.
- Nota:
- Questo valore viene ignorato se nessun listener implementa
navigator:didUpdateRemainingTime:.
- (CLLocationDistance) distanceUpdateThreshold [read, write, assign] |
La modifica minima della distanza stimata rispetto alla destinazione successiva che attiverà il metodo navigator:didUpdateRemainingDistance: da chiamare.
Se è impostato su CLLocationDistanceMax, i callback di aggiornamento della distanza verranno disattivati. Se è impostato su un valore negativo, verrà utilizzata la soglia predefinita di un metro. Il valore predefinito è un metro.
- Nota:
- Questo valore viene ignorato se nessun listener implementa
navigator:didUpdateRemainingDistance:.
- (NSTimeInterval) timeToNextDestination [read, assign] |
Restituisce il tempo stimato alla destinazione successiva.
Questa informazione verrà aggiornata in base alla posizione corrente del dispositivo mentre è attiva la guida.
Restituisce CLTimeIntervalMax se non è disponibile alcun percorso.
- (CLLocationDistance) distanceToNextDestination [read, assign] |
Restituisce la distanza stimata alla destinazione successiva.
Questa informazione verrà aggiornata in base alla posizione corrente del dispositivo mentre è attiva la guida.
Restituisce CLLocationDistanceMax se non è disponibile alcun percorso.
- (SalesforceNavigazioneDelayCategory) delayCategoryToNextDestination [read, assign] |
Restituisce la categoria del ritardo alla destinazione successiva.
Questa informazione verrà aggiornata in base alla posizione corrente del dispositivo mentre è attiva la guida.
Restituisce GSMNavigazioneDelayCategoryNoData se non sono disponibili route o dati di traffico non disponibili.
- (SalesforceRouteLeg*) currentRouteLeg [read, assign] |
L'attuale tappa del percorso.
Questo DASHRouteLeg avrà la sua posizione iniziale come la posizione nota più recente (sud-sapped) del dispositivo.
- (NSArray<SalesforceRouteLeg *>*) routeLegs [read, assign] |
Un array di gambe di percorso in cui ogni gamba corrisponde a una destinazione che è stata impostata.
- (SalesforcePath*) travelPath [read, assign] |
Il percorso percorso dal dispositivo dall'ultima volta in cui è stato impostato activeActive su YES.
Questo percorso è vuoto se la guida non è mai iniziata. Il percorso è costituito dal percorso sterrato strada come restituito da GMSRoadSnappedLocationProvider, ma semplificato per rimuovere i punti ridondanti. Ad esempio, puoi trasformare punti collinari consecutivi in un singolo segmento di linea.
- (DASHNavigazioneVoiceGuidance) voiceGuidance [read, write, assign] |
Determina se attivare la guida vocale per il traffico e gli avvisi passo passo.
Il valore predefinito è gsNavigazioneVoiceGuidanceAlertsAndGuidance.
- (SalesforceVoicenceAudioDeviceType) audioDeviceType [read, write, assign] |
Determina quali dispositivi audio possono essere riprodotti con guida vocale.
Il valore predefinito è GSMVoiceGuidanceAudioDeviceTypeBluetooth.
- (BOOL) vibrationEnabled [read, write, assign] |
Determina se il dispositivo deve anche vibrare quando vengono riprodotti gli avvisi vocali.
- (BOOL) sendsBackgroundNotification [read, write, assign] |
Determina se le UIUINotifiche contenenti informazioni sono presentate quando l'app è in background.
Il valore predefinito è SÌ.
- (SalesforceNavigazioneLightingMode) suggestedLightingMode [read, assign] |
La modalità di illuminazione suggerita, in base all'ora del giorno e alla posizione del dispositivo.
- (BOOL) dovDisplayPrompts [read, write, assign] |
Determina se devono essere visualizzati messaggi per il traffico, percorsi migliori e incidenti.
Il valore predefinito è SÌ.
- (DASHNavigazioneSpeedAlertOptions*) speedAlertOptions [read, write, assign] |
DASHNavigazioneSpeedAlertOptions per personalizzare le soglie di attivazione per DASHNavigazioneSpeedAlertSeverity.
Puoi utilizzare questa proprietà per personalizzare le soglie di attivazione dell'avviso di velocità in percentuale per gli avvisi di minore o maggiore entità. Puoi utilizzare questo metodo anche per personalizzare la soglia di attivazione basata sul tempo per l'avviso di velocità maggiore.
Impostando zero, non riceverai alcun dato sul feed di velocità e verrà visualizzato l'avviso di velocità predefinito del NavSDK: l'avviso di velocità mostra testo rosso quando la velocità è superiore a 5 mph o 10 km/h oltre il limite di velocità e mostra testo bianco e sfondo rosso quando la velocità è superiore a 10 mph o 20 km/h.