Suche entlang der Route

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

• Nur Text Search (New):Sie können nach Orten auf einer vordefinierten Route suchen.
• Text Search (New) und Nearby Search (New): Hier wird die Routenübersicht von einem angegebenen Startort bis zu jedem Ort in den Suchergebnissen berechnet.
• Nur „Text Search (New)“:Die Zusammenfassung der Routenführung für jeden Ort entlang einer vordefinierten Fahrtroute wird berechnet.

Entlang einer Route suchen

Mit der Routes API berechnen Sie die Route zwischen zwei Orten. Mit der Routes API können Sie eine Route für ein Auto, Fahrrad, Zweirad, öffentliche Verkehrsmittel oder zu Fuß berechnen.

Hinweis:Routen des öffentlichen Nahverkehrs werden von der Places API nicht unterstützt.

Mit Text Search (Neu) können Sie diese berechnete Route verwenden, um eine Suche entlang einer Route durchzuführen. Mit dieser Option übergeben Sie die vordefinierte Route aus 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 Darstellungsbereichsgrenzen liegen, während locationBias Suchergebnisse außerhalb des Darstellungsbereichs zurückgeben kann. Mit den Optionen locationBias und locationRestriction können Sie jedoch eine Region angeben, die die Suchergebnisse beeinflussen soll. Mit der Funktion „Entlang der Route suchen“ in „Text Search“ können Sie die Suchergebnisse aber auch gewichten, sodass diejenigen mit minimalen Umleitungszeiten vom Ausgangsort der Route zum Routenziel einbezogen werden. Sie können die Suchergebnisse mit locationBias oder locationRestriction in Kombination mit der Polylinie beeinflussen.

Betrachten Sie beispielsweise die Route vom Startpunkt, der in der Routes API als Wegpunkt bezeichnet wird, zum Ziel, wie sie von der Routes API berechnet wird:

Wenn Sie entlang der Route suchen, wird die Gewichtung so gewichtet, 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.

Zusammenfassung des Routings berechnen

Mit Text Search (New) und Nearby Search (New) kann die Routenübersicht, also Dauer und Entfernung, zu jedem Ort in der Antwort basierend auf dem angegebenen Startpunkt der Route in der Anfrage berechnet werden. Wenn Sie den Startort der Route angeben, enthält die Antwort nicht nur eine Liste der Orte, die mit der Suche übereinstimmen, sondern auch die Fahrtdauer und Entfernung vom Startort der Route zu den einzelnen Orten.

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 die Entfernung vom Startort des Routenplaners zum Ort, sofern verfügbar.

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

Standardmäßig werden die Reisedauer und Entfernung mit der Option TRAFFIC_UNAWARE in der Routes API berechnet. Sie können optional Einstellungen für die Routenberechnung festlegen, damit bei der Berechnung aktuelle Verkehrsbedingungen TRAFFIC_AWARE_OPTIMAL oder aktuelle Verkehrsbedingungen mit reduzierter Latenz TRAFFIC_AWARE berücksichtigt werden.

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

Wenn Sie die Option TRAFFIC_AWARE für die Routenberechnung festlegen, werden die Routen unter Berücksichtigung der Verkehrslage berechnet. So spiegeln die Route und die Routendetails die tatsächlichen Gegebenheiten besser wider. Da diese Steigerung der Datenqualität auf Kosten der Antwortlatenz geht, werden Leistungsoptimierungen angewendet, um einen Großteil der Latenz zu reduzieren. Wenn Sie die TRAFFIC_AWARE_OPTIMAL-Routingeinstellung festlegen, werden Routen unter Berücksichtigung der Verkehrslage 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, 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. Sie definieren diese Orte als Wegpunkte auf der Route. Wegpunkte sind Orte zwischen Start- und Zielort, die die Route passieren soll.

• Route: Die gesamte Fahrt vom Start- über alle Zwischen- bis zum Zielpunkt. Eine Route besteht aus einem oder mehreren Abschnitten.

  Wenn Sie eine Route an Text Search übergeben, übergeben Sie 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ängengraden, mit der Sie die Polylinie der Route als String darstellen können.

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

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

  Für jeden zusätzlichen Wegpunkt, den Sie der Route nach dem Start- und Zielort hinzufügen, wird von der API ein separater Abschnitt hinzugefügt. Dieser Wegpunkt wird als Zwischenstopp bezeichnet.

Weitere Informationen zu Routen und zum Berechnen von Routen finden Sie in der Routes API.

Routenübersicht mit einer Suche entlang der Route berechnen

Sie können Berechnungen der Zusammenfassung der Route mit der Suche entlang einer Route kombinieren. In diesem Fall gibt Text Search (New) die Fahrtdauer und die Entfernung zu jedem Ort in der Antwort zurück und dann von jedem Ort zum Endziel der Route. Stellen Sie sich diese Berechnung so vor, dass Sie eine Reisedauer und Entfernung erhalten, wenn Sie von der angegebenen Route umleiten, um zu einem Ort in den Suchergebnissen zu gelangen, und dann zum endgültigen Ziel fortfahren.

Betrachten Sie beispielsweise die folgende von der Routes API berechnete Route vom Start- zum Zielort. Übergeben Sie diesen Pfad 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 Entfernung, die für einen Umweg zu diesem Ort als zweiteilige Fahrt erforderlich ist:

• Der erste Abschnitt enthält die Reisedauer und die Entfernung vom Start 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 bis zum Ziel.

Anhand der Informationen in der Antwort können Sie dann die Dauer und Entfernung der Umleitung berechnen. Dabei gilt:

• \(t_{OD}\) ist die Fahrtdauer vom Start- zum Zielort und \(s_{OD}\) die Fahrtstrecke vom Start- zum Zielort.
• \(t_{OA}\) ist die Fahrtdauer vom Startort nach A; \(s_{OA}\) ist die Fahrtentfernung vom Startort nach A.
• \(t_{AD}\) ist die Fahrtdauer von A zum Ziel; \(s_{AD}\) ist die Fahrtstrecke von A zum Ziel.

Die Umleitungsdauer ist die Differenz der Dauer 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 Zielort) und der neuen Fahrt (vom Start- zum Zielort über A):

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