Plattform auswählen: Android iOS

Echtzeitunterbrechungen konfigurieren

Echtzeit-Störungen sind eine Sammlung von Funktionen, die Nutzer über Störungen auf ihrer Route informieren und es ihnen ermöglichen, Störungen zu melden und zu bestätigen. Beispiele für Störungen sind Verkehrsunfälle, Staus, Polizeikontrollen und Blitzer, Baustellen, Fahrbahnverengungen und bestimmte Wetterbedingungen. Auf dieser Seite werden die Funktionen für Echtzeitstörungen und ihre Konfigurationsoptionen beschrieben. Außerdem werden Aspekte für Apps mit benutzerdefinierten Navigations-UIs erläutert.

Funktionen für Echtzeitunterbrechungen

Das Navigation SDK umfasst die folgenden Echtzeit-Funktionen für Störungen als Teil der Kernnavigation:

Diese Funktionen sind konfigurierbar und standardmäßig aktiviert. In den folgenden Abschnitten finden Sie weitere Informationen zu den Funktionen und verfügbaren Konfigurationsoptionen.

Interaktive Hinweise zu Störungen entlang von Routen

Wenn in einer App eine Route angezeigt wird, entweder in einer Routenübersicht oder während der aktiven Navigation, werden alle aktuellen Störungen als Hinweisfelder entlang der Route angezeigt. Callouts enthalten ein Symbol, das den Typ der Störung angibt.

Hinweise entlang von Routen

Sie können die Anzeige von Hinweisen zu Störungen entlang von Routen mit setTrafficPromptsEnabled steuern. Damit wird auch die Anzeige automatischer Benachrichtigungen gesteuert, wenn sich ein Nutzer einer Störung nähert. 

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Details zu Störungen anzeigen, wenn ein Nutzer auf einen Hinweis tippt

Nutzer können auf einen Hinweis tippen, um eine Infokarte mit weiteren Informationen zur Störung aufzurufen, z. B. den Störungstyp, den Zeitpunkt, zu dem die Störung zuletzt gemeldet wurde, und in einigen Fällen eine Option, um darüber abzustimmen, ob die Störung noch vorhanden ist. Es gibt zwei verschiedene Arten von Infokarten, die je nachdem, ob sich der Nutzer in der aktiven Navigation befindet, angezeigt werden. Die Konfigurationsoptionen variieren für jeden Typ.

Hinweiskarten in Routenübersichten, bevor die aktive Navigation gestartet wird

Wenn ein Nutzer vor dem Start der aktiven Navigation auf einen Hinweis in der Routenübersicht tippt, wird eine Infokarte mit weiteren Informationen zur Störung angezeigt.

Übersichtskarte

Mit setTrafficIncidentCardsEnabled können Sie festlegen, ob Nutzer auf Routenübersichten auf Störungshinweise tippen können, um weitere Informationen aufzurufen. 

// Using the SupportNavigationFragment
mNavFragment.setTrafficIncidentCardsEnabled(true);

// Using the NavigationView
navigationView.setTrafficIncidentCardsEnabled(true);

Infokarten mit Hinweisen während der aktiven Navigation

Wenn während der aktiven Navigation ein Hinweis zu einer Verkehrsbehinderung auf einer Route angezeigt wird, können Nutzer darauf tippen, um eine Infokarte mit weiteren Informationen zur Verkehrsbehinderung aufzurufen. Dazu gehören der Typ der Verkehrsbehinderung und die Uhrzeit, zu der sie zuletzt gemeldet wurde. Außerdem werden Schaltflächen angezeigt, mit denen Nutzer abstimmen können, ob die Verkehrsbehinderung noch vorhanden ist. Von Nutzern eingereichte Meldungen werden von Google verarbeitet und können anderen Google Maps- und Navigation SDK-Nutzern auf der Karte angezeigt werden. Außerdem wird anhand dieser Meldungen entschieden, ob die Störung weiterhin angezeigt werden soll.

Infokarte für aktive Navigation

Sie können die Anzeige und Tippbarkeit von Hinweisen zu Störungen während der aktiven Navigation mit setTrafficPromptsEnabled steuern. Damit wird auch die Anzeige von Hinweisen entlang von Routen und die Anzeige automatischer Benachrichtigungen gesteuert, wenn sich ein Nutzer einer Störung nähert. 

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Automatisierte Benachrichtigungen zu Störungen mit Abstimmung während der aktiven Navigation

Wenn sich ein Nutzer während der aktiven Navigation einer Störung auf einer Route nähert, wird eine Aufforderung mit Informationen zur Störung und Schaltflächen zum Abstimmen darüber angezeigt, ob die Störung noch vorhanden ist. Von Nutzern abgegebene Stimmen werden von Google verarbeitet und können auf der Karte für andere Nutzer des Google Maps und Navigation SDK angezeigt werden. Außerdem wird anhand der Stimmen entschieden, ob die Verkehrsbehinderung weiterhin angezeigt werden soll.

Infokarte für aktive Navigation

Sie können die Anzeige von Warnhinweisen während der aktiven Navigation mit setTrafficPromptsEnabled konfigurieren. Damit wird auch die Anzeige von Hinweisen entlang von Routen gesteuert. 

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Meldung von Verkehrsbehinderungen während der aktiven Navigation

Während der aktive Navigationsmodus läuft, wird in der Navigationsbenutzeroberfläche eine Schaltfläche angezeigt, über die Nutzer neue Störungen auf ihrer Route melden können. Wenn ein Nutzer auf die Schaltfläche tippt, wird ein Menü mit den verfügbaren Störungstypen angezeigt, die gemeldet werden können. Von Nutzern eingereichte Berichte werden von Google verarbeitet und können auf der Karte für andere Nutzer des Google Maps und Navigation SDK angezeigt werden.

Schaltfläche „Melden“ Menü „Berichte“

Schaltfläche für Standardberichte ein- oder ausblenden

Sie können die Sichtbarkeit der Standardberichtsschaltfläche während der aktiven Navigation mit setReportIncidentButtonEnabled konfigurieren. 

// Enables the incident reporting button to show in situations where incident
// reporting is possible.

// Using the SupportNavigationFragment
mNavFragment.setReportIncidentButtonEnabled(true);

// Using the NavigationView
navigationView.setReportIncidentButtonEnabled(true);

Schaltfläche für benutzerdefinierte Berichte hinzufügen

Anstelle der Standardschaltfläche für die Meldung von Störungen können Sie der Navigations-UI eine benutzerdefinierte Schaltfläche für die Meldung von Störungen hinzufügen. Wenn der Nutzer auf die benutzerdefinierte Schaltfläche klickt, können Sie die Anzeige des Berichtsmenüs auslösen, indem Sie die Methode showReportIncidentsPanel aufrufen. Bevor Sie eine benutzerdefinierte Schaltfläche zum Melden hinzufügen, prüfen Sie mit isIncidentReportingAvailable, ob die App in der aktiven Navigation verwendet wird und der Nutzer sich in einem Land befindet, in dem das Melden aktiviert ist. Wenn eine dieser Bedingungen nicht zutrifft, wird das Berichtsmenü nicht angezeigt. 

  Button customReportIncidentButton = findViewById(R.id.custom_reporting_button);
  
  // Check if reporting is available before displaying your button
  customReportIncidentButton.setVisibility(
      navigationView.isReportingAvailable ? View.VISIBLE : View.GONE);
  
  // Trigger the reporting flow if the button is clicked
  customReportIncidentButton.setOnClickListener(v ->
      navigationView.showReportIncidentsPanel());

Mit benutzerdefinierten Navigations-UIs arbeiten

Wenn Ihre Implementierung des Navigation SDK benutzerdefinierte UI-Elemente enthält, müssen Sie die Echtzeit-Störungselemente berücksichtigen, um Konflikte zu vermeiden.

Positionierung der Schaltfläche für Berichte

Standardmäßig befindet sich die Schaltfläche zum Melden von Störungen unten auf der Karte – rechts bei linksläufigen Sprachen und links bei rechtsläufigen Sprachen. Wenn Sie die Schaltfläche für Berichte verschieben müssen, um Platz für benutzerdefinierte UI-Elemente zu schaffen, fügen Sie ein benutzerdefiniertes Steuerelement BOTTOM_END_BELOW oder FOOTER hinzu. Dadurch wird die Position der Schaltfläche auf dem Bildschirm nach oben verschoben. Wenn Sie Ihre eigenen benutzerdefinierten UIs in den benutzerdefinierten Steuerelementen platzieren, wird außerdem dafür gesorgt, dass alle vom Navigation SDK angezeigten Aufforderungen während der Anzeige richtig über Ihren benutzerdefinierten UI-Elementen eingeblendet werden. Wenn Sie keine benutzerdefinierten Steuerelemente verwenden können, nutzen Sie die Prompt Visibility API, um potenzielle Konflikte mit der Benutzeroberfläche zu verwalten.

Prompt Visibility API (experimentell)

Mit der Prompt Visibility API können Sie Konflikte zwischen UI-Elementen, die vom Navigation SDK generiert werden, und Ihren eigenen benutzerdefinierten UI-Elementen vermeiden. Dazu fügen Sie einen Listener hinzu, um einen Callback zu erhalten, bevor ein UI-Element des Navigation SDK angezeigt wird und sobald das Element entfernt wird. Sie können Callbacks für Echtzeit-Störungselemente erhalten, darunter Infokarten, Aufforderungen und das Menü zum Melden von Störungen, sowie für andere Benachrichtigungen, die vom Navigation SDK generiert werden. 
// Sample listener
val listener: PromptVisibilityChangedListener = { isVisible ->
	if (isVisible) {
		customFab.visibility = false
		customFooter.visibility = false
		moveSomeOtherThingsAround()
	} else {
		customFab.visibility = true
		customFooter.visibility = true
		moveSomeThingsBackToWhereTheyWereBefore()
	}
}

// Inside onCreate()
navigationView.addPromptVisibilityChangedListener(listener)

// Inside onDestroy()
navigationView.removePromptVisibilityChangedListener(listener)