Seleziona piattaforma:Android iOS

Configurare le interruzioni in tempo reale

Questo prodotto o questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

I disservizi in tempo reale sono un insieme di funzionalità che avvisano gli utenti dei disservizi lungo il loro percorso e consentono loro di segnalare e verificare i disservizi che incontrano. Esempi di interruzioni includono incidenti stradali, congestione del traffico, presenza di polizia e autovelox, lavori in corso, chiusure di corsie e determinate condizioni meteorologiche. Questa pagina descrive le funzionalità di interruzione in tempo reale e le relative opzioni di configurazione, inclusi i fattori da considerare per le app che utilizzano UI di navigazione personalizzate.

Nota:la disponibilità delle funzionalità di interruzione in tempo reale e di tipi specifici di interruzione varia in base alla regione. Per saperne di più, consulta Copertura di paesi e regioni dell'SDK Navigation. Inoltre, le interruzioni in tempo reale non sono disponibili su Apple CarPlay.

Funzionalità di interruzione in tempo reale

L'SDK Navigation include le seguenti funzionalità di interruzione in tempo reale nell'ambito dell'esperienza di navigazione di base:

• Callout interattivi per interruzioni lungo i percorsi.
• Avvisi automatici di interruzioni con votazione durante la navigazione attiva.
• Segnalazione di interruzioni durante la navigazione attiva.

Queste funzionalità sono configurabili e attive per impostazione predefinita. Le sezioni seguenti forniscono ulteriori informazioni sulle funzionalità e sulle opzioni di configurazione disponibili.

Avvisi interattivi di interruzioni lungo i percorsi

Quando un'app mostra un percorso, in una panoramica del percorso o durante la navigazione attiva, eventuali interruzioni correnti vengono visualizzate come fumetti lungo il percorso. I callout includono un'icona che indica il tipo di interruzione.

Puoi controllare la visualizzazione dei callout relativi ai disservizi lungo i percorsi utilizzando shouldDisplayPrompts, che controlla anche la visualizzazione degli avvisi automatici quando un utente si avvicina a un disservizio.

mapView.navigator.shouldDisplayPrompts = true

Mostrare i dettagli dell'interruzione quando un utente tocca una bolla

Gli utenti possono toccare un callout per visualizzare una scheda informativa con maggiori dettagli sul disservizio, tra cui il tipo di disservizio, l'ora dell'ultima segnalazione e, in alcuni casi, un'opzione per votare se il disservizio è ancora presente. A seconda che l'utente stia navigando attivamente o meno, possono essere visualizzati due diversi tipi di schede informative e le opzioni di configurazione variano per ogni tipo.

Schede informative dei callout nelle panoramiche del percorso, prima di avviare la navigazione attiva

Quando un utente tocca un callout nella panoramica di un percorso, prima di avviare la navigazione attiva, viene visualizzata una scheda informativa con ulteriori informazioni sul disservizio.

Puoi controllare la possibilità degli utenti di toccare i callout di interruzione negli itinerari per visualizzare ulteriori informazioni utilizzando showsIncidentCards.

mapView.settings.showsIncidentCards = true

Schede informative dei callout durante la navigazione attiva

Quando viene visualizzata una notifica di interruzione lungo un percorso durante la navigazione attiva, gli utenti possono toccarla per visualizzare una scheda informativa con maggiori dettagli sull'interruzione, tra cui il tipo di interruzione e l'ora dell'ultima segnalazione, nonché i pulsanti per votare se l'interruzione è ancora presente. I voti inviati dagli utenti vengono elaborati da Google e potrebbero essere visualizzati sulla mappa per altri utenti di Google Maps e dell'SDK Navigation, nonché utilizzati per determinare se continuare a mostrare l'interruzione.

Puoi controllare la visualizzazione e la possibilità di toccare i callout relativi ai disservizi durante la navigazione attiva utilizzando shouldDisplayPrompts, che controlla anche la visualizzazione dei callout lungo i percorsi e la visualizzazione degli avvisi automatici quando un utente si avvicina a un disservizio.

mapView.navigator.shouldDisplayPrompts = true

Avvisi automatici di interruzioni con votazione durante la navigazione attiva

Durante la navigazione attiva, quando un utente si avvicina a un problema lungo un percorso, viene visualizzato un prompt con informazioni sul problema e pulsanti per votare se il problema è ancora presente. I voti inviati dagli utenti vengono elaborati da Google e potrebbero essere visualizzati sulla mappa per altri utenti di Google Maps e dell'SDK Navigation, nonché utilizzati per determinare se continuare a mostrare l'interruzione.

Puoi configurare la visualizzazione dei prompt di avviso durante la navigazione attiva utilizzando shouldDisplayPrompts, che controlla anche la visualizzazione dei callout lungo i percorsi.

mapView.navigator.shouldDisplayPrompts = true

Nota: quando un utente si avvicina a un problema lungo un percorso durante la navigazione attiva, il problema viene annunciato con un avviso audio. Gli avvisi audio non sono interessati dalla configurazione della visualizzazione dei prompt. Tuttavia, puoi configurare tutti i prompt vocali durante la navigazione attiva utilizzando VoiceGuidance .

Segnalazione di interruzioni durante la navigazione attiva

Durante la modalità di navigazione attiva, nell'interfaccia utente di navigazione viene visualizzato un pulsante che consente agli utenti di segnalare nuovi disagi lungo il percorso. Quando un utente tocca il pulsante, viene visualizzato un menu con i tipi di interruzione disponibili da segnalare. Le segnalazioni inviate dagli utenti vengono elaborate da Google e potrebbero essere visualizzate sulla mappa per altri utenti dell'SDK Google Maps e Navigation.

Nota:quando un utente avvia la navigazione attiva, il pulsante di segnalazione viene visualizzato in uno stato espanso con l'etichetta "Segnala". Il pulsante si comprime per mostrare solo l'icona.

Mostrare o nascondere il pulsante per la segnalazione standard

Puoi configurare la visibilità del pulsante dei report standard durante la navigazione attiva utilizzando navigationReportIncidentButtonEnabled.

// Enables the incident reporting FAB to show in situations where incident
// reporting is possible.
mapView.settings.navigationReportIncidentButtonEnabled = true

Aggiungere un pulsante di segnalazione personalizzato

Al posto del pulsante standard per la segnalazione di interruzioni, puoi aggiungere un pulsante di segnalazione personalizzato all'interfaccia utente di navigazione. Quando l'utente fa clic sul pulsante personalizzato, puoi attivare la visualizzazione del menu dei report chiamando il metodo presentReportIncidentsPanel. Prima di aggiungere un pulsante di segnalazione personalizzato, verifica che l'app sia in navigazione attiva e che l'utente si trovi in un paese in cui la segnalazione è attivata chiamando reportIncidentsAvailable. Se una di queste condizioni non è vera, il menu di segnalazione non verrà visualizzato.

Nota:se implementi un pulsante di segnalazione personalizzato, assicurati di impostare navigationReportIncidentButtonEnabled su false (Swift) o NO` (Objective-C) per nascondere il pulsante di segnalazione standard.

  // Check if reporting is available before displaying your button
  let isReportingAvailable = mapview.isIncidentReportingAvailable()
  customReportingIncidentButton.isHidden = !isReportingAvailable
  customReportingIncidentButton.addTarget(self, action: #selector(didTapReportIncidentButton), for: .touchUpInside)
  
  // Trigger the reporting flow if the button is clicked
  func didTapReportIncidentButton() {
          mapView.presentReportIncidentsPanel(self) { [weak self] error in
              guard let self = self else { return }
              if let error = error as NSError? {
                  if error.domain == GMSMapViewPresentReportIncidentPanelErrorDomain {
                      let errorCode = GMSMapViewPresentReportIncidentPanelErrorCode(rawValue: error.code)
                      
                      switch errorCode {
                      case .internal:
                          self.showErrorMessage(
                              title: "Error Presenting Report Incident Panel",
                              message: "An internal error occurred."
                          )
                      case .reportingNotAvailable:
                          self.showErrorMessage(
                              title: "Error Presenting Report Incident Panel",
                              message: "Reporting is not available."
                          )
                      case .none:
                          self.showErrorMessage(
                              title: "Error Presenting Report Incident Panel",
                              message: "An unknown error occurred."
                          )
                      }
                  } else {
                      // Handle other potential errors (e.g., network errors)
                      self.showErrorMessage(
                          title: "Error Presenting Report Incident Panel",
                          message: "An unexpected error occurred: \(error.localizedDescription)"
                      )
                  }
              }
              // If error is nil, the panel was presented successfully. You can add any extra logic here.
          }
     }

Utilizzare interfacce utente di navigazione personalizzate

Se la tua implementazione dell'SDK di navigazione include elementi dell'interfaccia utente personalizzati, devi prendere in considerazione gli elementi di interruzione in tempo reale per evitare conflitti.

Nota: per saperne di più su come utilizzare gli elementi dell'interfaccia utente personalizzata, consulta Modificare l'interfaccia utente di navigazione.

Posizionamento del pulsante di segnalazione

Per impostazione predefinita, il pulsante per la segnalazione di interruzioni si trova nell'angolo finale/posteriore della mappa, sul lato destro per le lingue con direzione da sinistra a destra e sul lato sinistro per le lingue con direzione da destra a sinistra. Se devi spostare il pulsante dei report per fare spazio agli elementi dell'interfaccia utente personalizzata, utilizza un bottomTrailingButtonsLayoutGuide.

Swift

// Create a new layout guide
let topRightLayoutGuide = UILayoutGuide()
self.view.addLayoutGuide(topRightLayoutGuide)

// Activate constraints using fixed constants here as an example
// assuming the current reporting button is of fixed height
topRightLayoutGuide.topAnchor.constraint(equalTo: _mapView.navigationHeaderLayoutGuide.bottomAnchor, constant: 50).isActive = true
topRightLayoutGuide.trailingAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.trailingAnchor, constant: -14).isActive = true

// Assign the layout guide
_mapView.bottomTrailingButtonsLayoutGuide = topRightLayoutGuide

// Create an alternate layout guide to use when the header and the footer are not full width
let topRightAlternateLayoutGuide = UILayoutGuide()
self.view.addLayoutGuide(topRightAlternateLayoutGuide)

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
topRightAlternateLayoutGuide.topAnchor.constraint(equalTo: _mapView.navigationHeaderLayoutGuide.bottomAnchor, constant: 20).isActive = true
topRightAlternateLayoutGuide.trailingAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.trailingAnchor, constant: -10).isActive = true

// Assign the layout guide
_mapView.bottomTrailingButtonsAlternateLayoutGuide = topRightAlternateLayoutGuide

Objective-C

// Create a new layout guide
UILayoutGuide *topRightLayoutGuide = [[UILayoutGuide alloc] init];
[self.view addLayoutGuide:topRightLayoutGuide];

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
[[topRightLayoutGuide.topAnchor
    constraintEqualToAnchor:_mapView.navigationHeaderLayoutGuide.bottomAnchor
                   constant:50]
    setActive:YES];

[[topRightLayoutGuide.trailingAnchor
    constraintEqualToAnchor:self.view.safeAreaLayoutGuide.trailingAnchor
                   constant:-14]
    setActive:YES];

// Assign the layout guide
_mapView.bottomTrailingButtonsLayoutGuide = topRightLayoutGuide;

// Create an alternate layout guide to use when the header and the footer are not full width
UILayoutGuide *topRightAlternateLayoutGuide = [[UILayoutGuide alloc] init];
[self.view addLayoutGuide:topRightAlternateLayoutGuide];

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
[[topRightAlternateLayoutGuide.topAnchor
    constraintEqualToAnchor:_mapView.navigationHeaderLayoutGuide.bottomAnchor
                   constant:50]
    setActive:YES];

[[topRightAlternateLayoutGuide.trailingAnchor
    constraintEqualToAnchor:self.view.safeAreaLayoutGuide.trailingAnchor
                   constant:-14]
    setActive:YES];

// Assign the layout guide
_mapView.bottomTrailingButtonsAlternateLayoutGuide = topRightAlternateLayoutGuide;

API Prompt Visibility (sperimentale)

L'API Prompt Visibility ti aiuta a evitare conflitti tra gli elementi UI generati dall'SDK Navigation e i tuoi elementi UI personalizzati aggiungendo un listener per ricevere un callback prima che un elemento UI dell'SDK Navigation stia per essere visualizzato e non appena l'elemento viene rimosso. Puoi ricevere callback per gli elementi di interruzione in tempo reale, tra cui schede informative, prompt e il menu di segnalazione delle interruzioni, nonché per altre notifiche generate dall'SDK Navigation.

Swift

// Additional methods added to GMSNavigatorListener
...
func navigatorWillPresentPrompt(_ navigator: GMSNavigator) {
  // Hide any sort of custom UI element.
}

func navigatorDidDismissPrompt(_ navigator: GMSNavigator) {
  // Show any sort of custom UI element.
}
...

Objective-C

// Additional methods added to GMSNavigatorListener
...
- (void)navigatorWillPresentPrompt:(GMSNavigator *)navigator {
  // Hide any sort of custom UI element.
}

- (void)navigatorDidDismissPrompt:(GMSNavigator *)navigator {
  // Show any sort of custom UI element.
}
...