Suche entlang der Route

Die Funktionen „Suche entlang der Route“ sind in den folgenden Places (New) APIs verfügbar:

• Nur Text Search (New):Sie können nach Orten entlang einer vordefinierten Fahrtroute 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 Routenübersicht wird für jeden Ort entlang einer vordefinierten Fahrtroute 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 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 nur Ergebnisse mit minimalen Umwegzeiten vom Start- bis zum Zielort der Route berücksichtigt 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:

Bei der Suche entlang der Route werden Orte in der Nähe der Route mit minimalen Umwegzeiten vom Start- zum Zielort zurückgegeben. 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 Fahrtdauer und die Entfernung mit der Option TRAFFIC_UNAWARE in der Routes API berechnet. Sie können optional Routeneinstellungen 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 Routeneinstellungen mit einem nicht unterstützten Verkehrsmittel angegeben ist, 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 Routingübersicht 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 Verbesserung der Datenqualität zu Lasten der Antwortlatenz geht, werden Leistungsoptimierungen angewendet, um die Latenz weitgehend 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 die 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 Weg von einem Wegpunkt in einer Route zum nächsten Wegpunkt in der Route. Jedes Teil besteht aus einem oder mehreren einzelnen Schritten.

  Eine Route enthält einen separaten Abschnitt für den Weg 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 (Zwischenstopp), fügt die API einen separaten Abschnitt hinzu.

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 Routenübersicht 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. Diese Berechnung gibt die Fahrtdauer und -entfernung an, wenn Sie von der angegebenen Route abweichen, um zu einem Ort in den Suchergebnissen zu fahren, und dann zum Endziel weiterfahren.

Betrachten Sie beispielsweise die folgende Route vom Start- zum Zielort, die von der Routes API berechnet wurde. Ü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 bis 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 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 Startpunkt zu A; \(s_{OA}\) ist die Fahrtstrecke vom Startpunkt zu A.
• \(t_{AD}\) ist die Fahrtdauer von A zum Ziel; \(s_{AD}\) ist die Fahrtstrecke von A zum Ziel.

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

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