Suche entlang der Route

Die Funktionen „Suche entlang der 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): 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 mit öffentlichen Verkehrsmitteln werden von der Places API nicht unterstützt.

Mit der Funktion Text Search (New) können Sie mit dieser berechneten Route eine Entlang einer Route suchen Bei dieser Option übergeben Sie die vorab berechnete Route von der Routes API zur Anfrage „Text Search (New)“. Die Antwort enthält dann die den Suchkriterien entsprechen und sich in der Nähe der angegebenen Route.

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. Während Mit den Optionen locationBias und locationRestriction können Sie eine Region angeben, Suchergebnisse gewichten können, können Sie mit der Funktion für die Suche entlang der Route in der Textsuche auch Sie gewichten die Suchergebnisse so, dass sie auch diejenigen mit minimalen Umleitungszeiten vom Routenstart zum Ziel der Route. Zur Gewichtung der Suchergebnisse können Sie entweder locationBias oder locationRestriction in Kombination mit der Polylinie.

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 einer Suche entlang der Route werden Orte in der Nähe des Route mit minimalen Umleitungszeiten vom Start- zum Zielort. In diesem Beispiel sind die Punkte A, B und C Orte, die von der Suche zurückgegeben wurden.

Zusammenfassung der Routenplanung 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 Routenausgangspunkt angeben, enthält die Antwort nicht nur einen Liste der Orte, die der Suche entsprechen, sowie die Reisedauer und Entfernung vom Routingursprung zu jedem Ort.

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

Die Antwort enthält für jeden Ort in den Ergebnissen die Reisedauer und Entfernung vom Routenausgangspunkt zum Ort, falls 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 Reisezeit und -entfernung mithilfe des TRAFFIC_UNAWARE berechnet. in der Routes API. Optional können Sie Einstellungen für das Routing festlegen, aktuelle Verkehrslage TRAFFIC_AWARE_OPTIMAL oder latenzreduzierte Live-Verkehrsbedingungen TRAFFIC_AWARE die bei den Berechnungen berücksichtigt werden.

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

Wenn Sie die TRAFFIC_AWARE werden Routen unter Berücksichtigung der Verkehrslage berechnet. Als werden die Routen- und Routendetails die reale Umgebung genauer wiedergeben. . Da diese Steigerung der Datenqualität zulasten der Reaktion geht werden Leistungsoptimierungen angewendet, um die 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, Streckenabschnitte und Wegpunkte

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

Eine Route besteht aus den folgenden Komponenten:

• Wegpunkt: Zur Berechnung einer Route müssen Sie mindestens den Start- und Zielort angeben. Diese Standorte definieren Sie als Wegpunkte auf die Route berechnen. Wegpunkte sind Orte zwischen Ausgangs- und Ziel, durch das die Route verlaufen soll.

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

  Wenn Sie eine Route an Text Search übergeben, übergeben Sie den codierten Wert der route Polylinie, wie von der Routes API zurückgegeben. 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 in 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 zur Berechnung von Routen finden Sie unter Routen API hinzu.

Zusammenfassung der Routenplanung 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.

Nehmen wir zum Beispiel die folgende Route vom Start- zum Zielort: von der Routes API berechnet. Diese Route an die Text Search (New) API übergeben mit Ihren Suchkriterien.

In diesem Beispiel ist Standort A ein Ort, der in den Suchergebnissen von „Text“ zurückgegeben wird. Suche (Neu). 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 wird vom Ursprung bis 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 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 bis A; \(s_{OA}\) ist Die Fahrtentfernung vom Startpunkt nach A
• \(t_{AD}\) ist die Fahrtdauer von A zum Ziel; \(s_{AD}\) ist die Fahrtstrecke von A zum Ziel.

Die Umleitungsdauer entspricht der Differenz der Dauer zwischen der ursprünglichen Fahrt. (vom Start- zum Zielort) und die neue Fahrt (vom Start- bis zum Ziel) das Ziel über A):

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

Umleitungsentfernung ist die Entfernungsdifferenz zwischen der ursprünglichen Fahrt. (vom Start- zum Zielort) und die neue Fahrt (vom Start- bis zum Ziel) das Ziel über A):

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