Entlang der Route suchen – Übersicht

Funktionen für die 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 Route suchen.
• Text Search (New) und Nearby Search (New): Berechnen Sie die Zusammenfassung der Routen vom angegebenen Routenursprungsort zu jedem Ort in den Suchergebnissen.
• Nur Text Search (New):Berechnen Sie die Zusammenfassung der Routen für jeden Ort entlang einer vordefinierten Route.

Entlang einer Route suchen

Sie verwenden die Routes API, um die Route zwischen zwei Orten zu berechnen. Mit der Routes API kann eine Route für ein Auto, ein Fahrrad, ein Zweirad, öffentliche Verkehrsmittel oder für Fußgänger berechnet werden.

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

Mit Text Search (New) können Sie die berechnete Route für eine Suche entlang einer Route verwenden. Mit dieser Option übergeben Sie die vorab berechnete 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 gewichten. locationRestriction gibt Suchergebnisse zurück, die innerhalb der Darstellungsbereichsgrenzen liegen, während locationBias möglicherweise Suchergebnisse außerhalb des Darstellungsbereichs zurückgibt. 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 Routenstart bis zum Routenziel enthalten. Sie können Suchergebnisse entweder mit locationBias oder locationRestriction in Kombination mit der Polylinie beeinflussen.

Sehen Sie sich als Beispiel die Route vom Startpunkt (in der Routes API als Wegpunkt bezeichnet) zum Zielort an, die von der Routes API berechnet wird:

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

Zusammenfassung der Routenberechnung

Mit Text Search (New) und Nearby Search (New) kann die Zusammenfassung der Routen berechnet werden. Das bedeutet, dass die Dauer und Entfernung für jeden Ort in der Antwort auf Grundlage des angegebenen Routenursprungs in der Anfrage berechnet werden. Wenn Sie den Routing-Ursprung angeben, enthält die Antwort nicht nur eine Liste der Orte, die der Suche entsprechen, sondern auch die Reisedauer und Entfernung vom Routing-Ursprung zu jedem Ort.

Im folgenden Bild 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 Reisezeit und die Entfernung vom Startort der Routenplanung zum Ort, sofern verfügbar.

Hinweis:Dies ist nur eine Schätzung der Routinginformationen. Wenn Sie die tatsächlichen Routendetails, einschließlich detaillierter Wegbeschreibungen, abrufen möchten, verwenden Sie 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 Routeneinstellungen festlegen, damit bei der Berechnung aktuelle Verkehrsbedingungen TRAFFIC_AWARE_OPTIMAL oder latenzreduzierte aktuelle Verkehrsbedingungen TRAFFIC_AWARE berücksichtigt werden.

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

Wenn Sie die Routing-Einstellung TRAFFIC_AWARE festlegen, werden Routen unter Berücksichtigung der Verkehrsbedingungen berechnet. Dadurch werden die Route und die Routendetails genauer an die realen Bedingungen angepasst. Da diese Steigerung der Datenqualität auf Kosten der Antwortlatenz geht, werden Leistungsoptimierungen angewendet, um die Latenz zu verringern. Wenn Sie die Routing-Einstellung TRAFFIC_AWARE_OPTIMAL 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 mit der Routes API berechnete Route besteht aus mehreren Komponenten:

Eine Route besteht aus den folgenden Komponenten:

• Wegpunkt: Um eine Route zu berechnen, müssen Sie mindestens die Orte für Start- und Zielort angeben. Sie definieren diese Orte als Wegpunkte auf der Route. Wegpunkte sind Orte zwischen Start- und Zielort, die auf der Route liegen sollen.

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

  Wenn Sie eine Route an die Text Search API ü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ängengradpunkten, mit der die Polylinie der Route als String dargestellt werden kann.

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

  Eine Route enthält einen separaten Routenabschnitt für den Weg von jedem Wegpunkt zum nächsten. Wenn die Route beispielsweise einen einzelnen Start- und einen einzelnen Ziel-Waypoint 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 (ein sogenannter Zwischenwegpunkt), fügt die API einen separaten Abschnitt hinzu.

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

Routenzusammenfassung mit der Funktion „Entlang der Route suchen“ berechnen

Sie können Berechnungen für Routenzusammenfassung mit Suche entlang einer Route kombinieren. In diesem Fall gibt Text Search (New) in der Antwort die Reisezeit und Entfernung zu jedem Ort und dann von jedem Ort zum endgültigen Ziel der Route zurück. Diese Berechnung gibt die Reisedauer und ‑entfernung an, 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 Entfernung, die für einen Abstecher zu diesem Ort als zweiteilige Reise erforderlich sind:

• Der erste Abschnitt enthält die Reisezeit und die Entfernung vom Startort der Route zum Ort. In diesem Beispiel vom Ursprungsort zum 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 Umleitungsdauer und -strecke berechnen. Dabei gilt:

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

Die Umleitungsdauer ist die Dauerabweichung 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} $$