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 (nouvelles) suivantes:
- Text Search (nouveau) uniquement:recherchez des lieux sur un itinéraire prédéfini.
- Text Search (nouvelle version) et Nearby Search (nouvelle version) : calculez le résumé d'itinéraire à partir d'un lieu de départ spécifié et pour chaque lieu figurant dans les résultats de recherche.
- Recherche de texte (nouvelle) uniquement:calculez le résumé du calcul d'itinéraire pour chaque lieu sur un itinéraire de trajet prédéfini.
Rechercher sur un trajet
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 véhicule à deux roues, un système de transports en commun ou pour la marche.
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 alors les lieux correspondant aux critères de recherche et situés à proximité de l'itinéraire spécifié.
Effectuer une recherche le long d'un itinéraire est semblable à utiliser les 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, si les options locationBias
et locationRestriction
vous permettent de spécifier une région pour biaiser les résultats de recherche, la fonctionnalité de recherche sur un trajet dans la recherche textuelle vous permet également de biaiser les résultats de recherche pour inclure ceux qui présentent des temps de détour minimaux entre le point de départ et la destination du trajet. Vous pouvez biaiser les résultats de recherche à l'aide de locationBias
ou locationRestriction
en combinaison avec la polyligne.
Prenons l'exemple de l'itinéraire entre le point de départ, appelé point de cheminement dans l'API Routes, et la destination calculée par l'API Routes:
Lorsque vous effectuez une recherche sur votre itinéraire, la recherche est biaisée pour afficher des lieux à proximité 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 résumé du calcul d'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 du calcul d'itinéraire spécifié dans la requête. Lorsque vous spécifiez le point de départ du calcul d'itinéraire, la réponse ne contient pas seulement une liste des lieux correspondant à la recherche, mais également la durée du trajet et la distance entre le point de départ et chaque lieu.
Dans l'image suivante, les points A, B et C correspondent aux lieux renvoyés dans la réponse de recherche:
Pour chaque lieu des 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, le cas échéant.
Par défaut, la durée et la distance du trajet sont calculées à l'aide de l'option TRAFFIC_UNAWARE
dans l'API Routes. Vous pouvez éventuellement définir des préférences de calcul d'itinéraires 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.
À propos des itinéraires, des sections et des points de cheminement
Un itinéraire est composé de plusieurs composants, calculés par l'API Routes:
Une route se compose des composants suivants:
- Waypoint: pour calculer un itinéraire, vous devez spécifier au moins les emplacements de départ et de destination. Vous définissez ces emplacements en tant que points de cheminement sur le trajet. 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 cheminement de départ, via les éventuels points de cheminement intermédiaires, jusqu'au point de cheminement de destination. Un itinéraire se compose d'une ou de plusieurs sections.
Lorsque vous transmettez un itinéraire à la recherche textuelle, 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.
-
Trajet: chemin entre un point de cheminement d'un itinéraire et le point de cheminement suivant. Chaque étape comprend une ou plusieurs étapes distinctes.
Un itinéraire contient une section distincte pour le chemin entre chaque point de cheminement et le suivant. Par exemple, si l'itinéraire ne comporte qu'un seul point de départ et un seul point de destination, il ne comporte qu'une seule section.
Pour chaque point de cheminement supplémentaire que vous ajoutez au parcours après l'origine et la destination, appelé point de cheminement intermédiaire, l'API ajoute un tronçon distinct.
Pour en savoir plus sur les routes et le calcul des itinéraires, consultez l'API Routes.
Calculer le résumé du calcul d'itinéraire avec une recherche sur le trajet
Vous pouvez combiner les calculs du résumé du calcul d'itinéraire avec la recherche sur un itinéraire. Dans ce cas, Text Search (New) (Recherche textuelle (nouvelle version)) renvoie la durée et la distance du trajet vers chaque lieu de la réponse, puis de chaque lieu à la destination finale de l'itinéraire. Considérez ce calcul comme fournissant la durée et la distance du trajet si vous quittez l'itinéraire spécifié pour vous rendre à un lieu figurant dans les résultats de recherche, puis poursuivre vers la destination finale.
Prenons l'exemple du trajet 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 requises pour faire un trajet en deux étapes vers ce lieu:
- La première étape contient la durée du trajet et la distance entre le point de départ de l'itinéraire et le lieu. Dans cet exemple, de l'origine à l'emplacement 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 de 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 le point de départ et la destination. \(s_{OD}\) correspond à la distance du trajet entre le point de départ et la destination.
- \(t_{OA}\) correspond à la durée du trajet entre le point de départ et A. \(s_{OA}\) correspond à la distance du trajet entre le point de départ et A.
- \(t_{AD}\) correspond à la durée du trajet entre A et la destination. \(s_{AD}\) correspond à 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 (de l'origine à la destination) et le nouveau trajet (de l'origine à la destination via A):
La distance de déviation correspond à la différence de distance entre le trajet d'origine (de l'origine à la destination) et le nouveau trajet (de l'origine à la destination via A):