Rechercher sur le trajet

Pour utiliser Text Search (nouvelle version) 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 des lieux qui correspondent aux critères de recherche et qui sont également situés à proximité de l'itinéraire spécifié.

Pour rechercher des lieux sur un itinéraire :

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.

Par défaut, Text Search (nouveau) effectue la recherche sur l'ensemble de l'itinéraire, de l'origine à la destination, tel que 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.

Remarque : La recherche le long de l'itinéraire renvoie des lieux avec des temps de détour minimaux entre le point de départ et la destination. Si le point de départ et la destination de l'itinéraire sont identiques ou proches l'un de l'autre, la recherche le long de l'itinéraire peut ne renvoyer aucun résultat.

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.