Aperçu de la recherche sur votre trajet

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

  • Text Search (nouvelle version) uniquement:recherchez des lieux sur un itinéraire prédéfini.
  • Text Search (nouvelle version) et Nearby Search (nouvelle version) : calculez le résumé de l'itinéraire à partir d'un lieu de départ spécifié vers chaque lieu figurant dans les résultats de recherche.
  • Text Search (nouvelle version) uniquement:calculez le résumé de l'itinéraire pour chaque lieu situé sur un itinéraire 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 sur un itinéraire revient à utiliser les options de requête locationRestriction ou locationBias pour pondérer les résultats de recherche. locationRestriction renvoie des résultats de recherche qui se situent dans les limites de la fenêtre d'affichage, tandis que locationBias peut renvoyer des résultats en dehors de la fenêtre d'affichage. Toutefois, bien que les options locationBias et locationRestriction vous permettent de spécifier une région pour pondérer les résultats de recherche, la fonctionnalité de recherche en cours de trajet dans Text Search vous permet également de pondérer les résultats de recherche pour qu'ils incluent ceux qui présentent un détour minimal entre le point de départ de l'itinéraire 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.

Prenons l'exemple de l'itinéraire depuis le point de départ, appelé point de cheminement dans l'API Routes, jusqu'à la destination calculé par l'API Routes:

Itinéraire du point de départ au point d'arrivée avec les résultats de recherche.

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:

Les points A, B et C sont des lieux renvoyés dans la réponse de recherche.

Pour chaque lieu figurant 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, 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 routage pour prendre en compte les conditions de trafic en temps réel TRAFFIC_AWARE_OPTIMAL ou les conditions de trafic en temps réel dont la latence est 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:

Composants d'un parcours

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 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 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 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 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 sur le calcul des routes, consultez la documentation sur 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 (nouvelle version) avec vos critères de recherche.

Itinéraire du point de départ au point d'arrivée avec détour vers le résultat 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 (du point de départ à la destination) et le nouveau trajet (du point de départ à la destination via 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 via A):

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