Rechercher sur le trajet

Pour utiliser Text Search (nouvelle version) pour effectuer une recherche le long d'un itinéraire, transmettez l'itinéraire précalculé de l'API Routes dans la requête en tant que polyligne. La réponse contient les lieux correspondant aux critères de recherche et situés à proximité de l'itinéraire spécifié.

Pour rechercher sur un trajet:

1. Utilisez l'API Routes pour calculer un itinéraire qui renvoie la polyligne encodée d'un itinéraire dans la réponse.

   Remarque:Vous pouvez également encoder votre propre polyligne, comme décrit dans la section Format d'algorithme des polylignes encodées.

2. Utilisez le paramètre searchAlongRouteParameters.polyline.encodedPolyline pour transmettre la polyligne encodée du parcours à la recherche textuelle (nouvelle) afin de biaiser les résultats de recherche vers le parcours. La réponse contient alors les lieux qui correspondent aux critères de recherche et qui se trouvent également à proximité de l'itinéraire spécifié.

API Explorer vous permet d'envoyer des requêtes en direct afin de vous familiariser avec l'API et ses options:

Essayer

Par défaut, Text Search (nouveau) effectue la recherche sur l'ensemble du trajet de l'origine à la destination, comme défini par la polyligne. Dans l'exemple suivant, la polyligne définit l'itinéraire à partir de:

• Origine: 1600 Amphitheatre Parkway, Mountain View, CA
• Destination: 24 Willie Mays Plaza, San Francisco, CA

La polyligne encodée du trajet pour cet itinéraire est représentée par la chaîne:

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

Remarque:La recherche le long du parcours n'est compatible qu'avec une polyligne encodée, qui peut être transmise en tant que chaîne et inclut une compression avec une perte minimale. Il s'agit de la sortie par défaut de l'API Routes. Pour en savoir plus, consultez Demander des polylignes de parcours.

L'exemple suivant utilise la polyligne encodée de l'itinéraire pour biaiser les résultats de recherche:

  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'

La réponse contient les lieux correspondant aux critères de recherche, en fonction de l'itinéraire:

  {
    "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"
        }
      },
      /.../
    ]
  }

Vous n'avez pas besoin de biaiser les résultats pour l'ensemble de l'itinéraire. Par exemple, vous pouvez déjà être à mi-chemin du trajet avant d'effectuer la recherche. Dans ce cas, vous pouvez spécifier une origine de routage explicite à la recherche pour remplacer l'origine définie dans la polyligne encodée. Dans l'exemple suivant, vous spécifiez les coordonnées de latitude et de longitude de San Mateo (Californie), qui se trouve à peu près à mi-chemin de la polyligne du parcours:

  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'

Remarque:La recherche le long du trajet renvoie les lieux avec un temps de détour minimal entre le point de départ et la destination. Par conséquent, si le point de départ et la destination du trajet sont identiques ou proches, la recherche le long du trajet peut ne pas renvoyer de résultats.