Présentation de la recherche sur l'itinéraire

Les fonctionnalités de recherche sur l'itinéraire sont disponibles dans les API Places (New) suivantes :

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

Rechercher sur un itinéraire

Vous utilisez l'API Routes pour calculer l'itinéraire entre deux lieux. L'API Routes peut calculer un itinéraire pour une voiture, un vélo, un deux-roues, un réseau de transports en commun ou à pied.

Remarque : Les itinéraires des réseaux de transports en commun ne sont pas compatibles avec l'API Places (New).

Text Search (New) vous permet d'utiliser cet itinéraire calculé pour effectuer une recherche sur 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 se trouvent également à 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 biaiser 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, alors que les options locationBias et locationRestriction vous permettent de spécifier une région pour biaiser les résultats de recherche, la fonctionnalité de recherche le long d'un itinéraire dans Text Search vous permet également de biaiser les résultats de recherche pour inclure ceux qui présentent un temps de détour minimal entre le point de départ et la destination de l'itinéraire. Vous pouvez biaiser les résultats de recherche en utilisant locationBias ou locationRestriction en combinaison avec la polyligne.

Par exemple, considérons l'itinéraire entre le point de départ, appelé point de cheminement dans l'API Routes, et la destination, tel que calculé par l'API Routes :

Lorsque vous effectuez une recherche sur l'itinéraire, la recherche est biaisée pour renvoyer des lieux proches de l'itinéraire avec un temps de détour minimal entre le point de départ et la destination. Dans cet exemple, les points A, B et C sont des lieux renvoyés par la recherche.

Calculer le résumé du routage

Text Search (New) et Nearby Search (New) peuvent calculer le routing summary (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 routing origin location (lieu de départ de l'itinéraire) spécifié dans la requête. Lorsque vous spécifiez le point de départ de l'itinéraire, la réponse contient non seulement une liste de lieux correspondant à la recherche, mais aussi la durée et la distance du trajet entre le point de départ de l'itinéraire 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 du trajet et la distance 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, 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 d'itinéraire pour prendre en compte les conditions de circulation en temps réel TRAFFIC_AWARE_OPTIMAL ou les conditions de circulation en temps réel avec latence réduite TRAFFIC_AWARE lors des calculs.

Remarque : TRAFFIC_AWARE et TRAFFIC_OPTIMAL ne s'appliquent qu'aux modes de transport DRIVE et TWO_WHEELER. Si l'une des préférences de routage est spécifiée avec un mode de transport non compatible, le calcul du résumé de l'itinéraire utilise par défaut l'option TRAFFIC_UNAWARE. Si TWO_WHEELER est spécifié dans une région non compatible, 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 les détails de l'itinéraire 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 des réponses, 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

Plusieurs composants constituent un itinéraire, tel que calculé par l'API Routes :

Une route se compose des éléments suivants :

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

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

  Lorsque vous transmettez un itinéraire à Text Search, vous transmettez la polyligne 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.

• Section : trajet d'un point de cheminement à un autre dans un itinéraire. Chaque section est constituée d'une ou de 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 cheminement de départ et un seul point de cheminement de destination, il ne comporte qu'une seule section.

  Pour chaque point de cheminement supplémentaire que vous ajoutez à l'itinéraire après le départ et la destination, appelé point de cheminement intermédiaire, l'API ajoute une section distincte.

Pour en savoir plus sur les itinéraires et leur calcul, consultez la page API Routes.

Calculer le résumé de l'itinéraire avec une recherche le long de l'itinéraire

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

Par exemple, prenons l'itinéraire suivant entre le point de départ et 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 par ce lieu, sous la forme d'un trajet en deux étapes :

• La première étape contient la durée et la distance du trajet entre le point de départ de l'itinéraire et le lieu. Dans cet exemple, de l'origine au lieu A.
• La deuxième étape 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 de la réponse, vous pouvez ensuite calculer la durée et la distance du détour, où :

• \(t_{OD}\) est la durée du trajet du point de départ à la destination, \(s_{OD}\) est la distance du trajet du point de départ à la destination.
• \(t_{OA}\) est la durée du trajet du point de départ à A ; \(s_{OA}\) est la distance du trajet du point de départ à A.
• \(t_{AD}\) est la durée du trajet entre A et la destination ; \(s_{AD}\) est la distance du trajet entre A et la destination

La durée du détour correspond à la différence de durée 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) :

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

La distance du détour est 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} $$