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 (nouvelle) suivantes :

• Text Search (nouvelle version) uniquement:rechercher des lieux au cours d'un trajet prédéfini via un routage réseau.
• Text Search (nouvelle version) et Nearby Search (nouvelle version) : calculez l'itinéraire résumé depuis un lieu de départ d'itinéraire spécifié vers chaque lieu de la recherche résultats.
• 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 emplacements. L'API Routes peut calculer un itinéraire pour une voiture, un vélo, deux-roues, réseau de transports en commun ou marche.

Remarque : L'API Places n'est pas compatible avec les lignes de transports en commun.

Text Search (nouvelle version) vous permet d'utiliser cet itinéraire calculé pour effectuer une rechercher sur un itinéraire. Cette option permet de transmettre l'itinéraire précalculé de l'API Routes à la requête Text Search (New). La réponse contient ensuite lieux correspondant aux critères de recherche et situés à proximité de la destination via un routage réseau.

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 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 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 l'itinéraire, la recherche est faussée pour afficher les lieux à proximité 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 l'origine de routage, la réponse contient non seulement une la liste des lieux correspondant à la recherche, mais aussi la durée et la distance du trajet du point de départ de l'itinéraire à chaque lieu.

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

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, si disponible.

Remarque : Il ne s'agit que d'une estimation des informations de routage. Pour obtenir détails de l'itinéraire, y compris l'itinéraire détaillé, utilisez la fonction Itinéraires API.

Par défaut, la durée du trajet et la distance sont calculées à l'aide du 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.

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 calcul d'itinéraire est spécifiée avec un mode de transport non pris en charge, le calcul du récapitulatif d'itinéraire utilise par défaut l'option TRAFFIC_UNAWARE. Si TWO_WHEELER est spécifié dans un unsupported region, l'API renvoie une un résumé du routage vide.

Lorsque vous définissez TRAFFIC_AWARE d'itinéraire, 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 augmentation 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 TRAFFIC_AWARE_OPTIMAL la préférence d'itinéraire, 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 étapes et des points de cheminement

Un itinéraire est composé de plusieurs composants, calculés par l'API Routes :

Une route comprend les composants suivants:

• Waypoint (Point de passage) : pour calculer un itinéraire, vous devez au moins indiquer le nombre de lieux du point de départ et de la destination. Vous définissez ces emplacements en tant que points de cheminement sur le trajet. Les points de cheminement intermédiaires sont des emplacements situés entre le point de départ et le point de départ la destination que vous souhaitez emprunter pour l'itinéraire.

• Itinéraire : trajet complet du point de cheminement de départ, via les points de cheminement intermédiaires, jusqu'au point de cheminement de destination. Un itinéraire comprend ou plusieurs jambes.

  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 de l'itinéraire. Chaque étape se compose d'une ou de 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 à l'itinéraire après le point de départ et point de cheminement intermédiaire, l'API ajoute une étape distincte.

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 (nouvelle version) renvoie la durée du voyage et la distance entre chaque lieu de la réponse, puis de chaque lieu la destination 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 de l'itinéraire suivant entre le point de départ et la destination calculé par l'API Routes. Transmettez cet itinéraire à l'API Text Search (nouvelle version) avec 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 section indique la durée du trajet et la distance par rapport à l'itinéraire. origin sur le lieu. Dans cet exemple, de l'origine place 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 alors calculer le détour durée et distance, 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}\) est la durée du trajet entre le point de départ et le point A ; \(s_{OA}\) est la distance du trajet entre le point de départ et le point 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 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 via A):

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