Rechercher sur le trajet

Pour utiliser Text Search (nouvelle version) afin d'effectuer une recherche le long d'un itinéraire, transmettez l'itinéraire précalculé de l'API Routes dans la requête sous forme de polyligne. La réponse contient des lieux qui correspondent aux critères de recherche et qui sont également situés à proximité de l'itinéraire spécifié.

Pour effectuer une recherche 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 Format d'algorithme des polylignes encodées.

2. Utilisez le paramètre searchAlongRouteParameters.polyline.encodedPolyline pour transmettre la polyligne encodée de l'itinéraire à la recherche de texte (nouveau) afin de biaiser les résultats de recherche vers l'itinéraire. La réponse contient ensuite les lieux qui correspondent aux critères de recherche et qui sont également situés à proximité de l'itinéraire spécifié.

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

Essayer

Par défaut, Text Search (nouveau) effectue la recherche sur l'ensemble de l'itinéraire, de l'origine à la destination, tel qu'il est défini par la polyligne. Dans l'exemple suivant, la polyligne définit l'itinéraire 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 suivante :

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 de l'itinéraire n'accepte qu'une polyligne encodée, qui peut être transmise sous forme de 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 d'itinéraire.

L'exemple suivant utilise la polyligne encodée de la route 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 qui correspondent aux critères de recherche, avec un biais pour 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'itinéraire entier. Par exemple, vous pouvez être à mi-chemin de votre itinéraire avant d'effectuer la recherche. Dans ce cas, vous pouvez spécifier une origine de routage explicite pour la recherche afin de 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, en Californie, qui se trouve à peu près à mi-chemin de la polyligne de l'itinéraire :

  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 : Étant donné que la recherche le long d'un itinéraire renvoie des lieux avec des temps de détour minimaux entre le point de départ et la destination, il est possible qu'elle ne renvoie aucun résultat si le point de départ et la destination de l'itinéraire sont identiques ou proches l'un de l'autre.

Essayer

APIs Explorer vous permet d'effectuer des exemples de requêtes pour vous familiariser avec l'API et ses options.

1. Sélectionnez l'icône API api à droite de la page.

2. Vous pouvez également modifier les paramètres de la requête.

3. Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, sélectionnez le compte que vous souhaitez utiliser pour envoyer la demande.

4. Dans le panneau APIs Explorer, sélectionnez l'icône plein écran fullscreen pour développer la fenêtre APIs Explorer.