Quando la navigazione è attiva, l'SDK Navigation per Android mostra un controllo del limite di velocità nell'angolo in basso a sinistra della mappa che indica il limite di velocità attuale. Se un utente supera il limite di velocità, il controllo si espande per mostrare un tachimetro accanto al display del limite di velocità e attiva avvisi quando la velocità raggiunge una determinata soglia.
Per impostazione predefinita, l'SDK Navigation attiva un avviso di velocità minore quando l'utente supera il limite di velocità di 8 km/h e cambia il colore del testo del tachimetro in rosso. Attiva un avviso di velocità importante quando l'utente supera il limite di velocità di 16 km/h e cambia il colore di sfondo del tachimetro in rosso.
Puoi personalizzare sia la soglia per l'attivazione degli avvisi sia i colori del testo e dello sfondo visualizzati dal tachimetro. Puoi anche utilizzare l'SDK Navigation per rendere disponibili le informazioni sulla velocità dell'utente in base alle soglie che hai impostato. Ad esempio, potresti rendere disponibili le informazioni sulla velocità agli operatori di ridesharing per aiutarli a incoraggiare i loro utenti a rispettare i limiti di velocità e migliorare la sicurezza.
Personalizzare le soglie per gli avvisi di velocità
Puoi personalizzare la soglia di avviso di velocità sia per gli avvisi di velocità minori che per quelli maggiori in percentuale rispetto al limite di velocità attuale. Puoi anche specificare per quanto tempo la soglia viene superata prima che la mappa mostri l'avviso.
L'esempio di codice seguente imposta la soglia per un avviso di velocità minore al 5% oltre il limite di velocità e la soglia per un avviso di velocità maggiore al 10% oltre il limite di velocità. Specifica che la mappa mostra un avviso dopo che una soglia di avviso è stata superata per cinque secondi.
float minorSpeedAlertThresholdPercentage = 5; float
majorSpeedAlertThresholdPercentage = 10; double severityUpgradeDurationSeconds =
5;
// Configure SpeedAlertOptions SpeedAlertOptions.Builder
speedAlertOptionsBuilder = new SpeedAlertOptions.Builder();
speedAlertOptionsBuilder.setSpeedAlertThresholdPercentage(
SpeedAlertSeverity.MINOR, minorSpeedAlertThresholdPercentage);
speedAlertOptionsBuilder.setSpeedAlertThresholdPercentage(
SpeedAlertSeverity.MAJOR, majorSpeedAlertThresholdPercentage);
speedAlertOptionsBuilder.setSeverityUpgradeDurationSeconds(severityUpgradeDurationSeconds);
// Set SpeedAlertOptions to Navigator.
navigator.setSpeedAlertOptions(speedAlertOptionsBuilder.build());
Personalizzare la modalità di visualizzazione degli avvisi di velocità sul tachimetro
Per rendere gli avvisi di velocità più accattivanti, puoi personalizzare i colori del display del tachimetro per ogni livello di avviso.
La tabella seguente mostra i colori predefiniti per gli avvisi di velocità nella classe NavigationView:
| Elemento | Colore |
|---|---|
| MinorSpeedAlertBackgroundColorDayMode | 0xffffff(bianco) |
| MinorSpeedAlertBackgroundColorNightMode | 0x000000 |
| MinorSpeedAlertTextColorDayMode | 0xd93025 |
| MinorSpeedAlertTextColorNightMode | 0xd93025 |
| MajorSpeedAlertBackgroundColorDayMode | 0xd93025 |
| MajorSpeedAlertBackgroundColorNightMode | 0xd93025 |
| MajorSpeedAlertTextColorDayMode | 0xffffff(bianco) |
| MajorSpeedAlertTextColorNightMode | 0xffffff(bianco) |
Puoi specificare il colore del testo e dello sfondo del tachimetro per gli avvisi di velocità minori e maggiori:
SpeedometerUiOptions speedometerUiOptions = new SpeedometerUiOptions.Builder()
.setBackgroundColorDayMode(MINOR, some_color)
.setBackgroundColorNightMode(MINOR, some_color) .setTextColorDayMode(MINOR,
some_color) .setTextColorNightMode(MINOR, some_color)
.setBackgroundColorDayMode(MAJOR, some_color)
.setBackgroundColorNightMode(MAJOR, some_color) .setTextColorDayMode(MAJOR,
some_color) .setTextColorNightMode(MAJOR, some_color) .build();
// Set SpeedometerUiOptions to NavigationView.
navigationView.setSpeedometerUiOptions(speedometerUiOptionsBuilder.build());
navigationView.setSpeedometerEnabled(true);
// Set SpeedometerUiOptions to SupportNavigationFragment.
supportNavigationFragment.setSpeedometerUiOptions(speedometerUiOptionsBuilder.build());
supportNavigationFragment.setSpeedometerEnabled(true);
Ricevere informazioni sulla velocità dagli utenti
Se la tua applicazione richiede la condivisione di informazioni sulla velocità dell'utente, puoi anche utilizzare l'SDK Navigation per rendere disponibili le informazioni sulla velocità dell'utente. Ad esempio, questa funzionalità può essere utile per le applicazioni di ridesharing in cui un operatore potrebbe voler monitorare l'eccessiva velocità degli utenti per migliorare la sicurezza. Questa operazione può essere eseguita anche senza dover visualizzare una schermata di navigazione per l'utente nella tua app.
Ad esempio, il seguente esempio condivide le informazioni sulla velocità quando questa supera una percentuale specificata del limite di velocità:
// Existing flow for creating Navigator. NavigationApi.getNavigator();
// Set the SpeedAlertOptions for the MAJOR and MINOR alerts. (Note that the //
severityUpgradeDurationSeconds field is by design not used in this flow.)
SpeedAlertOptions speedAlertOptions = ...;
navigator.setSpeedAlertOptions(speedAlertOptions);
// Implement SpeedingListener. SpeedingListener speedingListener = new
SpeedingListener() { @Override public void onSpeedingUpdated(float
percentageAboveLimit, SpeedAlertSeverity speedAlertSeverity) { ... } };
// Set speedingListener to Navigator.
navigator.setSpeedingListener(speedingListener);