Übersicht über die Suche entlang der Route

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

• Nur Text Search (New): Orte entlang einer vordefinierten Route suchen.
• Text Search (New) und Nearby Search (New): Die Routenübersicht wird von einem angegebenen Startort zu jedem Ort in den Suchergebnissen berechnet.
• Nur Text Search (New): Berechnet die Routenübersicht für jeden Ort entlang einer vordefinierten Route.

Entlang einer Route suchen

Mit der Routes API können Sie die Route 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ßgänger berechnen.

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

Mit Text Search (New) können Sie diese berechnete Route für eine Suche entlang einer Route verwenden. Bei dieser Option übergeben Sie 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 können Sie zwar eine Region angeben, um die Suchergebnisse zu beeinflussen, aber mit der Funktion „Suche entlang der Route“ in der Textsuche können Sie die Suchergebnisse auch so beeinflussen, dass sie Ergebnisse mit minimalen Umwegzeiten vom Start- zum Zielpunkt der Route enthalten. Sie können Suchergebnisse entweder mit locationBias oder locationRestriction in Kombination mit der Polylinie beeinflussen.

Sehen Sie sich beispielsweise die Route vom Startpunkt (in der Routes API als Wegpunkt bezeichnet) zum Ziel an, wie sie von der Routes API berechnet wird:

Wenn Sie entlang der Route suchen, werden bevorzugt Orte in der Nähe der Route zurückgegeben, die nur minimale Umwege vom Start- zum Zielort erfordern. In diesem Beispiel sind die Punkte A, B und C Orte, die von der Suche zurückgegeben werden.

Routenzusammenfassung berechnen

Mit Text Search (New) und Nearby Search (New) kann die Routenübersicht, d. h. die Dauer und Entfernung, zu jedem Ort in der Antwort basierend auf dem angegebenen Startort der Route in der Anfrage berechnet werden. Wenn Sie den Startpunkt für das Routing angeben, enthält die Antwort nicht nur eine Liste der Orte, die der Suche entsprechen, sondern auch die Reisedauer und die Entfernung vom Startpunkt zu jedem Ort.

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

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

Hinweis: Dies ist nur eine Schätzung der Routinginformationen. Die tatsächlichen Routendetails, einschließlich detaillierter Wegbeschreibungen, erhalten Sie über die Routes API.

Standardmäßig werden die Reisedauer und die Entfernung mit der Option TRAFFIC_UNAWARE in der Routes API berechnet. Optional können Sie Routenpräferenzen festlegen, um die aktuelle Verkehrslage (TRAFFIC_AWARE_OPTIMAL) oder die aktuelle Verkehrslage mit reduzierter Latenz (TRAFFIC_AWARE) bei den Berechnungen zu berücksichtigen.

Hinweis: TRAFFIC_AWARE und TRAFFIC_OPTIMAL gelten nur für die Mobilitätsformen DRIVE und TWO_WHEELER. Wenn eine der Routenpräferenzen mit einem nicht unterstützten Fortbewegungsmittel angegeben wird, wird für die Berechnung der Routenübersicht standardmäßig die Option TRAFFIC_UNAWARE verwendet. Wenn TWO_WHEELER in einer nicht unterstützten Region angegeben ist, gibt die API eine leere Routenübersicht zurück.

Wenn Sie die Routenpräferenz TRAFFIC_AWARE festlegen, wird die Verkehrslage bei der Routenberechnung berücksichtigt. So spiegeln die Route und die Routendetails die realen Bedingungen genauer wider. Da diese Erhöhung der Datenqualität auf Kosten der Antwortlatenz geht, werden Leistungsoptimierungen angewendet, um einen Großteil der Latenz zu reduzieren. Wenn Sie die Routenpräferenz TRAFFIC_AWARE_OPTIMAL festlegen, werden Routen unter Berücksichtigung der Verkehrslage berechnet, aber es werden keine Leistungsoptimierungen angewendet. In diesem Modus führt der Server eine umfassendere Suche im Straßennetz durch, um die optimale Route zu finden.

Routen, Abschnitte und Wegpunkte

Eine Route besteht aus mehreren Komponenten, die von der Routes API berechnet werden:

Eine Route besteht aus den folgenden Komponenten:

• Waypoint: Zur Berechnung einer Route müssen Sie mindestens den Start- und Zielort angeben. Diese Orte werden als Wegpunkte auf der Route definiert. Zwischenwegpunkte sind Orte zwischen Start- und Zielort, die auf der Route liegen sollen.

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

  Wenn Sie eine Route an Text Search übergeben, übergeben Sie die codierte Polylinie der Route, die von der Routes API zurückgegeben wird. Eine codierte Polylinie ist eine codierte Liste von Breiten- und Längengraden, mit der Sie die Polylinie der Route als String darstellen können.

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

  Eine Route enthält für jeden Wegpunkt einen separaten Abschnitt bis zum nächsten Wegpunkt. Wenn die Route beispielsweise nur einen Start- und einen Zielwegpunkt enthält, besteht sie aus einem einzigen Abschnitt.

  Für jeden zusätzlichen Wegpunkt, den Sie nach dem Start- und Zielpunkt zur Route hinzufügen, wird von der API ein separater Abschnitt hinzugefügt. Diese Wegpunkte werden als Zwischenwegpunkte bezeichnet.

Weitere Informationen zu Routen und zur Routenberechnung finden Sie unter Routes API.

Routenübersicht mit einer Suche entlang der Route berechnen

Sie können Berechnungen der Routenzusammenfassung mit der Suche entlang einer Route kombinieren. In diesem Fall gibt Text Search (New) die Reisedauer und die Entfernung zu jedem Ort in der Antwort zurück und dann von jedem Ort zum endgültigen Ziel der Route. Diese Berechnung liefert die Reisedauer und -entfernung, wenn Sie von der angegebenen Route abweichen, um zu einem Ort in den Suchergebnissen zu fahren, und dann zum endgültigen Ziel weiterfahren.

Betrachten Sie beispielsweise die folgende Route vom Start- zum Zielort, die von der Routes API berechnet wurde. Übergeben Sie diese Route zusammen mit Ihren 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 wird. Für jeden Ort in der Antwort enthält die Suche die Dauer und die Entfernung, die für den Umweg zu diesem Ort erforderlich sind, als Fahrt mit zwei Abschnitten:

• Der erste Abschnitt enthält die Reisedauer und die Entfernung vom Startpunkt der Route zum Ort. In diesem Beispiel vom Startpunkt zu Ort A.
• Der zweite Abschnitt enthält die Reisedauer und die Entfernung vom Ort zum Ziel der Route. In diesem Beispiel von A zum Ziel.

Anhand der Informationen in der Antwort können Sie dann die Dauer und Entfernung des Umwegs berechnen:

• \(t_{OD}\) ist die Fahrtdauer vom Start- zum Zielort, \(s_{OD}\) ist die Fahrtstrecke vom Start- zum Zielort
• \(t_{OA}\) ist die Fahrtdauer vom Startpunkt bis A; \(s_{OA}\) ist die Fahrtstrecke vom Startpunkt bis A
• \(t_{AD}\) ist die Fahrtdauer von A zum Ziel; \(s_{AD}\) ist die Fahrtstrecke von A zum Ziel

Die Umwegdauer ist die Dauerdifferenz zwischen der ursprünglichen Fahrt (vom Start- zum Zielort) und der neuen Fahrt (vom Start- zum Zielort über A):

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

Die Umwegstrecke ist die Entfernungsdifferenz zwischen der ursprünglichen Fahrt (vom Start zum Ziel) und der neuen Fahrt (vom Start zum Ziel über A):

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