Entlang der Route suchen

Wenn Sie mit der Text Search (New) entlang einer Route suchen möchten, übergeben Sie die vorab berechnete Route aus der Routes API in der Anfrage als Polylinie. Die Antwort enthält Orte, die den Suchkriterien entsprechen und sich in der Nähe der angegebenen Route befinden.

So suchen Sie entlang einer Route:

1. Berechnen Sie mit der Routes API eine Route, die in der Antwort die codierte Polylinie der Route zurückgibt.

   Hinweis: Sie können auch Ihre eigene Polylinie codieren, wie in Codiertes Polylinien-Algorithmusformat beschrieben.

2. Verwenden Sie den searchAlongRouteParameters.polyline.encodedPolyline Parameter, um die codierte Polylinie der Route an die Text Search (New) zu übergeben und die Suchergebnisse auf die Route auszurichten. Die Antwort enthält dann Orte, die den Suchkriterien entsprechen und sich in der Nähe der angegebenen Route befinden.

Mit dem APIs Explorer können Sie Live-Anfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:

Testen!

Standardmäßig führt die Text Search (New) die Suche entlang der gesamten Route vom Start- zum Zielort durch, wie durch die Polylinie definiert. Im folgenden Beispiel definiert die Polylinie die Route von:

• Startort: 1600 Amphitheatre Parkway, Mountain View, CA
• Zielort: 24 Willie Mays Plaza, San Francisco, CA

Die codierte Polylinie der Fahrt für diese Route wird durch den folgenden String dargestellt:

wblcFptchVIFOd@G@EVw@Ms@dHKR}ApNA`AF~@Hf@TjAb@bBb@~@n@p@^Rd@~@Vz@HVz@nDLt@?d@Kr@c@~@mD`G?`@aEfGkCnDuChDm`@bb@[`@{GhHeEdEciBnnBkC`DkC~DaClEuKjT_Z|l@Qb@iR~_@}EzJ_AdB_Und@kAfCaOjZkg@vcAqBzD_]rr@iBlEaBxEgArD}AlG}AhHsA`IeAnH{@dIq@dJgL~iBq@rHu@vGgAtHwArHaBhHkBzG_DpJ}Nbc@iBhGkA|EgC|LcIjb@oAhG_AvDgAdDkApC_BzCiBpCsFvGii@vn@scAxlAmLjNgSzUeRjT{TzWqExEmG|FuNlMmMhLaRvPqOlNmbAl}@mFlF{PlOmJfIoElE}LtMiSbU_H`I}}@jcAwl@vp@oAbBqA~BeAhCm@tBg@fCWrBQ~BI|DaB~rBO~D[bEa@`Dm@pDaAdE{@vC_BbEkB~Def@|z@sEzHKJeS~]}K`S{\\~l@cXpe@sBpDm@bAuCxDkBrBiC~BwCtByBnAcBx@}Bt@{Bn@gh@|LaOpDeFhAoDj@aE^kVrA_E^iEr@yD~@uBr@gMjF_EnAcCh@eFr@_DRsAD}@Jsu@xCWDqIV}BCeCOyDm@cBa@_DmA}JeE_CwAsBcBiBoBuAqBmOoX{CuEkB_CoDqDkVoUoD{CeE_DkEkC_FeCqB}@sDuAoDgAeCe@cCW}CK}BDaDTeOlBcuBrYaNlBq@Dyd@rGyFt@yBb@eBf@oCnAoBlAkIpGkAp@wBbAaCt@oFdAwKjBoGxA{FbByIjC_HfB_@KmNdDuC|@uFzBcH|C{@\\[?sBv@}@VaBVoA@y@EmAQcA[w@]aBkAeAkA}BuDUKs@uAqBsCwBcCgAiAiN_MyKsJsG{GkBaBiBuA{BwAwDkBcOaHiC_AiCg@}BQcCAcBHqBVkB`@qEjAu@LgCVgAHwG@sG?mABsH^eNr@mBXy@NqBt@uAt@aBlAkAlA}BtCyApBiAdB_BxB{A`B}@j@oAf@s@PeCVcIf@gAAkAQy@YiAo@_A{@_DgEgJqM_DeEaM}PoBiCzAsBw@kAdAGVk@f@q@z@C

Hinweis:Die Suche entlang der Route unterstützt nur eine codierte Polylinie, die als String übergeben werden kann und eine Komprimierung mit minimalem Verlust beinhaltet. Dies ist die Standardausgabe der Routes API. Weitere Informationen finden Sie unter Routenpolylinien anfordern.

Im folgenden Beispiel wird die codierte Polylinie der Route verwendet, um die Suchergebnisse zu beeinflussen:

  curl -X POST -d '{
    "textQuery" : "Spicy Vegetarian Food",
    "searchAlongRouteParameters": {
      "polyline": {
        "encodedPolyline": "ROUTE_POLYLINE"
      }
    }
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
  'https://places.googleapis.com/v1/places:searchText'

Die Antwort enthält die Orte, die den Suchkriterien entsprechen und auf die Route ausgerichtet sind:

  {
    "places": [
      {
        "formattedAddress": "60 Morris St, San Francisco, CA 94107, USA",
        "priceLevel": "PRICE_LEVEL_MODERATE",
        "displayName": {
          "text": "Umami Express",
          "languageCode": "en"
        }
      },
      {
        "formattedAddress": "1130 4th St, San Francisco, CA 94158, USA",
        "priceLevel": "PRICE_LEVEL_MODERATE",
        "displayName": {
          "text": "House of Tadu Ethiopian Kitchen",
          "languageCode": "en"
        }
      },
      {
        "formattedAddress": "1602 El Camino Real Ste A, Belmont, CA 94002, USA",
        "priceLevel": "PRICE_LEVEL_MODERATE",
        "displayName": {
          "text": "Eats Meets West Bowls",
          "languageCode": "en"
        }
      },
      /.../
    ]
  }

Sie müssen die Ergebnisse nicht auf die gesamte Route ausrichten. Möglicherweise sind Sie beispielsweise bereits auf halber Strecke, bevor Sie die Suche durchführen. In diesem Fall können Sie einen expliziten Startort für die Suche angeben, um den in der codierten Polylinie definierten Startort zu überschreiben. Im folgenden Beispiel geben Sie die Breiten- und Längengrade von San Mateo, Kalifornien, an, das ungefähr auf halber Strecke der Routenpolylinie liegt:

  curl -X POST -d '{
    "textQuery" : "Spicy Vegetarian Food",
    "searchAlongRouteParameters": {
      "polyline": {
        "encodedPolyline": "ROUTE_POLYLINE"
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": 37.56617,
        "longitude": -122.30870
      }
    }
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
  'https://places.googleapis.com/v1/places:searchText'

Hinweis: Da bei der Suche entlang der Route Orte mit minimalen Umleitungszeiten vom Start- zum Zielort zurückgegeben werden, werden in Fällen, in denen Start- und Zielort der Route identisch oder nah beieinander liegen, möglicherweise keine Ergebnisse zurückgegeben.

Testen!

Mit dem APIs Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.

1. Wählen Sie rechts auf der Seite das API-Symbol api aus.

2. Optional können Sie die Anfrageparameter bearbeiten.

3. Wählen Sie die Schaltfläche Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, mit dem Sie die Anfrage stellen möchten.

4. Wählen Sie im Bereich „APIs Explorer“ das Vollbildsymbol fullscreen aus, um das Fenster „APIs Explorer“ zu maximieren.