Quando la navigazione è abilitata, l'SDK di navigazione per Android mostra un controllo del limite di velocità nell'angolo in basso a sinistra della mappa che mostra il limite di velocità attuale. Se un conducente supera il limite di velocità, il controllo si espande mostrando un tachimetro accanto alla visualizzazione del limite di velocità e attiva degli avvisi quando la velocità raggiunge una determinata soglia.
Per impostazione predefinita, l'SDK di navigazione attiva un avviso di velocità minore quando il conducente supera il limite di velocità di 5 mph (o 10 km/h) e cambia il colore del testo del tachimetro in rosso. Attiva un avviso di velocità significativo quando il conducente supera il limite di velocità di 20 km/h e imposta il colore di sfondo del tachimetro su 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 di navigazione per rendere disponibili le informazioni sulla velocità del conducente in base alle soglie che hai impostato. Ad esempio, potresti rendere disponibili informazioni sulla velocità agli operatori di ridesharing per incoraggiarli a rispettare il limite di velocità e migliorare la sicurezza.
Personalizza le soglie per gli avvisi di velocità
Puoi personalizzare la soglia di avviso di velocità per gli avvisi di velocità minori e principali sotto forma di 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à principale 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());
Personalizza la modalità di visualizzazione degli avvisi di velocità nel 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 testo e il colore di sfondo del tachimetro per gli avvisi di velocità minori e principali:
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à dai conducenti
Se la tua applicazione richiede la condivisione di informazioni sulla velocità del conducente, puoi anche utilizzare l'SDK di navigazione per rendere disponibili le informazioni sulla velocità del conducente. Questo può essere utile per applicazioni di ridesharing in cui un operatore potrebbe voler monitorare l'eccessiva velocità dei conducenti per migliorare la sicurezza. Questa operazione può anche essere eseguita senza dover eseguire il rendering di una visualizzazione di navigazione per l'utente nell'app.
Ad esempio, nell'esempio seguente vengono condivise informazioni sulla velocità quando la velocità supera una determinata percentuale rispetto al limite:
// 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);