Übersicht über die Suche entlang einer Route

Die Funktionen für die Suche entlang einer Route sind in den folgenden Places (New) APIs verfügbar:

• Nur Text Search (New):Suche nach Orten entlang einer vordefinierten Reise route.
• Text Search (New) und Nearby Search (New): Berechne die Routenzusammenfassung von einem angegebenen Routenstartort zu jedem Ort in den Suchergebnissen.
• Nur Text Search (New):Berechne die Routenzusammenfassung für jeden Ort entlang einer vordefinierten Reiseroute.

Entlang einer Route suchen

Mit der Routes API kannst du die Reiseroute zwischen zwei Orten berechnen. Die Routes API kann eine Route für ein Auto, ein Fahrrad, ein Zweirad, ein öffentliches Verkehrsmittel oder für Fußwege berechnen.

Hinweis:Routen für öffentliche Verkehrsmittel werden von der Places API nicht unterstützt.

Text Search (New) ermöglicht es dir, diese berechnete Route zu verwenden, um eine Suche entlang einer Route durchzuführen. Bei dieser Option übergibst du die vorab berechnete Route von der Routes API an die Text Search (New)-Anfrage. Die Antwort enthält dann Orte, die den Suchkriterien entsprechen und sich in der Nähe der angegebenen Route befinden.

Die Suche entlang einer Route ähnelt der Verwendung der Anfrageoptionen locationRestriction oder locationBias, um die Suchergebnisse zu beeinflussen. locationRestriction gibt Suchergebnisse zurück, die innerhalb der Grenzen des Darstellungsbereichs liegen, während locationBias Suchergebnisse außerhalb des Darstellungsbereichs zurückgeben kann. Mit den Optionen locationBias und locationRestriction kannst du jedoch eine Region angeben, um die Suchergebnisse zu beeinflussen. Mit der Funktion „Entlang einer Route suchen“ in Text Search kannst du die Suchergebnisse auch so beeinflussen, dass sie Ergebnisse mit minimalen Umleitungszeiten vom Routenstart zum Routenziel enthalten. Du kannst Suchergebnisse mit locationBias oder locationRestriction in Kombination mit der Polylinie beeinflussen.

Betrachte beispielsweise die Route vom Startort, der in der Routes API als Wegpunkt bezeichnet wird, zum Zielort, wie sie von der Routes API berechnet wurde:

Wenn du entlang der Route suchst, wird die Suche so beeinflusst, dass Orte in der Nähe der Route mit minimalen Umleitungszeiten vom Start- zum Zielort zurückgegeben werden. In diesem Beispiel sind die Punkte A, B und C Orte, die von der Suche zurückgegeben wurden.

Routenzusammenfassung berechnen

Text Search (New) und Nearby Search (New) können die Routenzusammenfassung berechnen, d. h. die Dauer und Entfernung zu jedem Ort in der Antwort basierend auf dem angegebenen Routenstartort in der Anfrage. Wenn du den Routenstartort angibst, enthält die Antwort nicht nur eine Liste von Orten, die der Suche entsprechen, sondern auch die Reisedauer und Entfernung vom Routenstartort zu jedem Ort.

In der folgenden Abbildung sind die Punkte A, B und C Orte, die in der Suchantwort zurückgegeben wurden:

Für jeden Ort in den Ergebnissen enthält die Antwort die Reisedauer und Entfernung vom Routenstartort zum Ort, sofern verfügbar.

Hinweis:Dies ist nur eine Schätzung der Routeninformationen. Die tatsächlichen Routendetails, einschließlich einer detaillierten Wegbeschreibung, erhältst du über die Routes API.

Standardmäßig werden Reisedauer und Entfernung mit der TRAFFIC_UNAWARE Option in der Routes API berechnet. Optional kannst du Routeneinstellungen festlegen, um aktuelle Verkehrsbedingungen TRAFFIC_AWARE_OPTIMAL oder latenzreduzierte aktuelle Verkehrsbedingungen TRAFFIC_AWARE bei den Berechnungen zu berücksichtigen.

Hinweis:TRAFFIC_AWARE und TRAFFIC_OPTIMAL gelten nur für die Reisemodi DRIVE und TWO_WHEELER. Wenn eine der beiden Routeneinstellungen mit einem nicht unterstützten Reisemodus angegeben wird, wird für die Berechnung der Routenzusammenfassung standardmäßig die Option TRAFFIC_UNAWARE verwendet. Wenn TWO_WHEELER in einer nicht unterstützten Region angegeben wird, gibt die API eine leere Routenzusammenfassung zurück.

Wenn du die TRAFFIC_AWARE Routeneinstellung festlegst, werden Routen unter Berücksichtigung der Verkehrsbedingungen berechnet. Dadurch spiegeln die Route und die Routendetails die realen Bedingungen genauer wider. Da diese Steigerung der Datenqualität mit einer höheren Antwortlatenz einhergeht, werden Leistungsoptimierungen angewendet, um die Latenz zu reduzieren. Wenn du die TRAFFIC_AWARE_OPTIMAL Routeneinstellung festlegst, werden Routen unter Berücksichtigung der Verkehrsbedingungen berechnet, es werden jedoch keine Leistungsoptimierungen angewendet. In diesem Modus führt der Server eine umfassendere Suche im Straßennetz durch, um die optimale Route zu finden.

Routen, Routenabschnitte und Wegpunkte

Eine Route, wie sie von der Routes API berechnet wird, besteht aus mehreren Komponenten:

Eine Route besteht aus den folgenden Komponenten:

• Waypoint: Um eine Route zu berechnen, musst du mindestens die Orte für Start und Ziel angeben. Diese Orte werden als Wegpunkte auf der Route definiert. Zwischenwegpunkte sind Orte zwischen Start und Ziel, die auf der Route liegen sollen.

• Route: Die gesamte Reise vom Startwegpunkt über alle Zwischenwegpunkte zum Zielwegpunkt. Eine Route besteht aus einem oder mehreren Routenabschnitten.

  Wenn du eine Route an Text Search übergibst, übergibst du die codierte Polylinie der Route, wie sie von der Routes API zurückgegeben wird. Eine codierte Polylinie ist eine codierte Liste von Breiten- und Längengradpunkten, mit der du die Polylinie der Route als String darstellen kannst.

• Routenabschnitt: Der Pfad von einem Wegpunkt auf einer Route zum nächsten Wegpunkt auf der Route. Jeder Routenabschnitt besteht aus einem oder mehreren einzelnen Schritten.

  Eine Route enthält einen separaten Routenabschnitt für den Pfad von jedem Wegpunkt zum nächsten. Wenn die Route beispielsweise einen Start- und einen einzelnen Zielwegpunkt enthält, besteht die Route aus einem einzigen Routenabschnitt.

  Für jeden zusätzlichen Wegpunkt, den du der Route nach Start und Ziel hinzufügst (ein Zwischenwegpunkt), fügt die API einen separaten Routenabschnitt hinzu.

Weitere Informationen zu Routen und zum Berechnen von Routen findest du in der Routes API.

Routenzusammenfassung mit einer Suche entlang einer Route berechnen

Du kannst Berechnungen der Routenzusammenfassung mit der Suche entlang einer Route kombinieren. In diesem Fall gibt Text Search (New) die Reisedauer und Entfernung zu jedem Ort in der Antwort und dann von jedem Ort zum endgültigen Ziel der Route zurück. Diese Berechnung gibt die Reisedauer und Entfernung an, wenn du von der angegebenen Route abweichst, um zu einem Ort in den Suchergebnissen zu reisen, und dann zum endgültigen Ziel weiterfährst.

Betrachte beispielsweise die folgende Route vom Start- zum Zielort, wie sie von der Routes API berechnet wurde. Übergib diese Route zusammen mit deinen Suchkriterien an die Text Search (New) API.

In diesem Beispiel ist Ort A ein Ort, der in den Suchergebnissen von Text Search (New) zurückgegeben wurde. Für jeden Ort in der Antwort enthält die Suche die Dauer und Entfernung, die für eine Umleitung zu diesem Ort erforderlich sind, als Reise mit zwei Routenabschnitten:

• Der erste Routenabschnitt enthält die Reisedauer und Entfernung vom Routen Startort zum Ort. In diesem Beispiel vom Startort zum Ort A.
• Der zweite Routenabschnitt enthält die Reisedauer und Entfernung vom Ort zum Zielort der Route. In diesem Beispiel von A zum Zielort.

Anhand der Informationen in der Antwort kannst du dann die Dauer und Entfernung der Umleitung berechnen. Dabei gilt:

• \(t_{OD}\) ist die Reisedauer vom Start- zum Zielort, \(s_{OD}\) ist die Reiseentfernung vom Start- zum Zielort
• \(t_{OA}\) ist die Reisedauer vom Startort nach A; \(s_{OA}\) ist die Reiseentfernung vom Startort nach A
• \(t_{AD}\) ist die Reisedauer von A zum Zielort; \(s_{AD}\) ist die Reiseentfernung von A zum Zielort

Die Dauer der Umleitung ist die Differenz der Dauer zwischen der ursprünglichen Reise (vom Start- zum Zielort) und der neuen Reise (vom Start- zum Zielort über A):

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

Die Entfernung der Umleitung ist die Differenz der Entfernung zwischen der ursprünglichen Reise (vom Start- zum Zielort) und der neuen Reise (vom Start- zum Zielort über A):

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$