Présentation de la recherche sur le trajet

Les fonctionnalités de recherche le long d'un itinéraire sont disponibles dans les API Places (New) suivantes :

• Text Search (nouveau) uniquement : recherchez des lieux le long d'un itinéraire de voyage prédéfini.
• Text Search (New) et Nearby Search (New) : calculez le récapitulatif de l'itinéraire à partir d'un point de départ spécifié vers chaque lieu dans les résultats de recherche.
• Recherche de texte (nouveau) uniquement : calculez le récapitulatif de l'itinéraire pour chaque lieu le long d'un itinéraire de voyage prédéfini.

Rechercher sur un itinéraire

Vous utilisez l'API Routes pour calculer l'itinéraire du trajet entre deux lieux. L'API Routes peut calculer un itinéraire pour une voiture, un vélo, un deux-roues, un système de transport en commun ou à pied.

Remarque : L'API Places n'est pas compatible avec les itinéraires des systèmes de transport en commun.

Text Search (New) vous permet d'utiliser cet itinéraire calculé pour effectuer une recherche le long d'un itinéraire. Avec cette option, vous transmettez l'itinéraire précalculé de l'API Routes à la requête Text Search (New). 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é.

La recherche le long d'un itinéraire est semblable à l'utilisation des options de requête locationRestriction ou locationBias pour orienter les résultats de recherche. locationRestriction renvoie les résultats de recherche qui se trouvent dans les limites de la fenêtre d'affichage, tandis que locationBias peut renvoyer des résultats de recherche en dehors de la fenêtre d'affichage. Toutefois, si les options locationBias et locationRestriction vous permettent de spécifier une région pour orienter les résultats de recherche, la fonctionnalité de recherche le long d'un itinéraire dans la recherche de texte vous permet également d'orienter les résultats de recherche pour inclure ceux avec des temps de détour minimaux entre l'origine et la destination de l'itinéraire. Vous pouvez biaiser les résultats de recherche à l'aide de locationBias ou locationRestriction en combinaison avec la polyligne.

Par exemple, prenons l'itinéraire du point de départ, appelé waypoint dans l'API Routes, à la destination, tel qu'il est calculé par l'API Routes :

Lorsque vous effectuez une recherche sur l'itinéraire, les résultats sont biaisés pour renvoyer des lieux proches de l'itinéraire avec des temps de détour minimaux entre l'origine et la destination. Dans cet exemple, les points A, B et C sont des lieux renvoyés par la recherche.

Calculer le récapitulatif de l'itinéraire

Text Search (New) et Nearby Search (New) peuvent calculer le récapitulatif de l'itinéraire (c'est-à-dire la durée et la distance) pour chaque lieu de la réponse en fonction du lieu de départ de l'itinéraire spécifié dans la requête. Lorsque vous spécifiez l'origine du routage, la réponse contient non seulement une liste des lieux correspondant à la recherche, mais aussi la durée et la distance du trajet entre l'origine du routage et chaque lieu.

Dans l'image suivante, les points A, B et C sont des lieux renvoyés dans la réponse de recherche :

Pour chaque lieu dans les résultats, la réponse contient la durée et la distance du trajet entre le point de départ de l'itinéraire et le lieu, si elles sont disponibles.

Remarque : Il ne s'agit que d'une estimation des informations de routage. Pour obtenir les détails de l'itinéraire réel, y compris les instructions détaillées, utilisez l'API Routes.

Par défaut, la durée et la distance du trajet sont calculées à l'aide de l'option TRAFFIC_UNAWARE de l'API Routes. Vous pouvez éventuellement définir des préférences de routage pour prendre en compte les conditions de circulation en temps réel TRAFFIC_AWARE_OPTIMAL ou les conditions de circulation en temps réel à latence réduite TRAFFIC_AWARE lors des calculs.

Remarque : TRAFFIC_AWARE et TRAFFIC_OPTIMAL ne s'appliquent qu'aux modes de déplacement DRIVE et TWO_WHEELER. Si l'une des préférences de routage est spécifiée avec un mode de déplacement non pris en charge, le calcul du récapitulatif de routage utilise par défaut l'option TRAFFIC_UNAWARE. Si TWO_WHEELER est spécifié dans une région non acceptée, l'API renvoie un récapitulatif de routage vide.

Lorsque vous définissez la préférence de routage TRAFFIC_AWARE, les itinéraires sont calculés en tenant compte des conditions de circulation. Par conséquent, l'itinéraire et ses détails reflètent plus précisément les conditions réelles. Étant donné que cette amélioration de la qualité des données se fait au détriment de la latence de réponse, des optimisations des performances sont appliquées pour réduire une grande partie de la latence. Lorsque vous définissez la préférence de routage TRAFFIC_AWARE_OPTIMAL, les itinéraires sont calculés en tenant compte des conditions de circulation, mais aucune optimisation des performances n'est appliquée. Dans ce mode, le serveur effectue une recherche plus exhaustive du réseau routier pour trouver l'itinéraire optimal.

À propos des itinéraires, des sections et des points de cheminement

Un itinéraire calculé par l'API Routes se compose de plusieurs éléments :

Une route se compose des éléments suivants :

• Point de cheminement : pour calculer un itinéraire, vous devez au minimum spécifier les lieux de départ et de destination. Vous définissez ces lieux comme des points de repère sur l'itinéraire. Les points de cheminement intermédiaires sont des lieux situés entre le point de départ et la destination que vous souhaitez que l'itinéraire traverse.

• Itinéraire : trajet complet du point de départ au point de destination, en passant par les points intermédiaires. Un itinéraire se compose d'une ou de plusieurs sections.

  Lorsque vous transmettez un itinéraire à la recherche de texte, vous transmettez la polyline encodée de l'itinéraire telle qu'elle est renvoyée par l'API Routes. Une polyligne encodée est une liste encodée de points de latitude et de longitude qui vous permet de représenter la polyligne de l'itinéraire sous forme de chaîne.

• Tronçon : chemin d'un point de repère à un autre dans un itinéraire. Chaque étape est constituée d'une ou plusieurs étapes distinctes.

  Un itinéraire contient une section distincte pour le trajet entre chaque point de cheminement et le suivant. Par exemple, si l'itinéraire contient un seul point de départ et un seul point de destination, il ne comporte qu'une seule section.

  Pour chaque point de repère supplémentaire que vous ajoutez à l'itinéraire après l'origine et la destination, appelé point de repère intermédiaire, l'API ajoute une étape distincte.

Pour en savoir plus sur les routes et leur calcul, consultez l'API Routes.

Calculer le récapitulatif de l'itinéraire avec une recherche sur le trajet

Vous pouvez combiner les calculs du récapitulatif de l'itinéraire avec la recherche le long d'un itinéraire. Dans ce cas, Text Search (nouvelle version) renvoie la durée et la distance du trajet vers chaque lieu de la réponse, puis de chaque lieu vers la destination finale de l'itinéraire. Ce calcul fournit la durée et la distance du trajet si vous déviez de l'itinéraire spécifié pour vous rendre à un lieu figurant dans les résultats de recherche, puis que vous continuez jusqu'à la destination finale.

Par exemple, prenons l'itinéraire suivant de l'origine à la destination, tel que calculé par l'API Routes. Transmettez cet itinéraire à l'API Text Search (New) avec vos critères de recherche.

Dans cet exemple, le lieu A est un lieu renvoyé dans les résultats de recherche de Text Search (New). Pour chaque lieu de la réponse, la recherche inclut la durée et la distance nécessaires pour faire un détour vers ce lieu sous la forme d'un trajet en deux étapes :

• La première section contient la durée et la distance du trajet entre le point de départ et le lieu. Dans cet exemple, de l'origine au lieu A.
• La deuxième section contient la durée et la distance du trajet entre le lieu et la destination de l'itinéraire. Dans cet exemple, de A à la destination.

À partir des informations contenues dans la réponse, vous pouvez ensuite calculer la durée et la distance du détour, où :

• \(t_{OD}\) correspond à la durée du trajet entre l'origine et la destination, et \(s_{OD}\) correspond à la distance du trajet entre l'origine et la destination.
• \(t_{OA}\) correspond à la durée du trajet de l'origine à A ; \(s_{OA}\) correspond à la distance du trajet de l'origine à A.
• \(t_{AD}\) correspond à la durée du trajet de A à la destination ; \(s_{AD}\) correspond à la distance du trajet de A à la destination.

La durée du détour correspond à la différence de durée entre le trajet d'origine (de l'origine à la destination) et le nouveau trajet (de l'origine à la destination en passant par A) :

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

La distance du détour correspond à la différence de distance entre le trajet d'origine (du point de départ à la destination) et le nouveau trajet (du point de départ à la destination en passant par A) :

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$