Rechercher sur le trajet

Pour utiliser Text Search (nouveau) 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 rechercher des lieux 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.

Par défaut, Text Search (nouveau) effectue la recherche sur l'ensemble de l'itinéraire, du point de départ à la destination, tel que 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 94043 États-Unis
• 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 sur le trajet 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.

Remarque : Étant donné que la recherche sur le trajet 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 si 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 envoyer la requête.

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