Rechercher sur le trajet

Pour utiliser Text Search (New) afin de rechercher des lieux 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 les lieux qui correspondent aux critères de recherche et qui se trouvent également à proximité de l'itinéraire spécifié.

Pour effectuer une recherche le long d'un itinéraire :

1. Utilisez l'API Routes pour calculer un itinéraire qui renvoie la polyligne encodée de l'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 de l'itinéraire à Text Search (New) afin de biaiser les résultats de recherche vers l'itinéraire. 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é.

L'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 (New) effectue la recherche sur l'ensemble de l'itinéraire, du point de départ à la destination, tel qu'il est défini par la polyligne. Dans l'exemple suivant, la polyligne définit l'itinéraire suivant :

• Point de départ : 1600 Amphitheatre Parkway, Mountain View, CA
• Destination: 24 Willie Mays Plaza, San Francisco, CA

La polyligne encodée de 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 d'un itinéraire n'est compatible qu'avec 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 la section Demander des polylignes d'itinéraire.

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 qui correspondent aux critères de recherche, biaisés vers 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 vers l'ensemble de l'itinéraire. Par exemple, vous pouvez déjà être à mi-chemin de l'itinéraire avant d'effectuer la recherche. Dans ce cas, vous pouvez spécifier un point de départ explicite pour la recherche afin de remplacer celui défini 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, elle peut ne renvoyer aucun résultat lorsque le point de départ et la destination de l'itinéraire sont identiques ou proches l'un de l'autre.

Essayer

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

1. Sélectionnez l'icône d'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, choisissez le compte que vous souhaitez utiliser pour effectuer la requête.

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