Descripción general de la búsqueda en la ruta

Las funciones de búsqueda a lo largo de la ruta están disponibles en las siguientes APIs de Places (nuevas):

• Solo Text Search (nueva): Busca lugares a lo largo de una ruta de viaje predefinida.
• Text Search (nueva) y Nearby Search (nueva): Calcula el resumen de planificación de ruta desde una ubicación de origen de planificación de ruta especificada hasta cada lugar de los resultados de la búsqueda.
• Solo para la Búsqueda de texto (nueva): Calcula el resumen de planificación de ruta para cada lugar a lo largo de una ruta de viaje predefinida.

Cómo buscar en una ruta

Usas la API de Routes para calcular la ruta del viaje entre dos ubicaciones. La API de Routes puede calcular una ruta para un automóvil, una bicicleta, vehículo de dos ruedas, sistema de transporte público o para caminar.

Nota: Las rutas del sistema de transporte público no son compatibles con la API de Places.

Text Search (nueva) te permite usar esta ruta calculada para realizar una búsqueda a lo largo de una ruta. Con esta opción, pasas la ruta calculada previamente de la API de Routes a la solicitud de Text Search (nuevo). Luego, la respuesta contiene lugares que coinciden con los criterios de búsqueda y que también se encuentran cerca de la ruta especificada.

La búsqueda a lo largo de una ruta es similar a usar locationRestriction o Opciones de solicitud de locationBias para personalizar los resultados de la búsqueda. locationRestriction muestra los resultados de la búsqueda que se encuentran dentro de los límites del viewport, mientras que locationBias puede mostrar resultados de la búsqueda fuera del viewport. Sin embargo, si bien las opciones locationBias y locationRestriction te permiten especificar una región para sesgar los resultados de la búsqueda, la función de búsqueda a lo largo de la ruta en la Búsqueda de texto también te permite sesgar los resultados de la búsqueda para incluir aquellos con tiempos de desvío mínimos desde el origen de la ruta hasta el destino. Puedes personalizar los resultados de la búsqueda mediante locationBias o locationRestriction en combinación con la polilínea

Por ejemplo, considera la ruta desde el origen, denominada punto de referencia en la API de Routes, hasta el destino que calcula la API de Routes:

Cuando realizas una búsqueda a lo largo de la ruta, la búsqueda se personaliza para mostrar lugares cerca de la ruta con tiempos de desvío mínimos desde el origen hasta el destino. En este ejemplo, los puntos A, B y C son lugares devueltos por la búsqueda.

Calcula el resumen de enrutamiento

Text Search (nueva) y Nearby Search (nueva) pueden calcular el resumen de rutas, es decir, la duración y la distancia, a cada lugar en la respuesta según la ubicación de origen de la ruta especificada en la para cada solicitud. Cuando especificas el origen de enrutamiento, la respuesta no solo contiene la lista de lugares que coinciden con la búsqueda, así como la duración y distancia del viaje desde el origen de la ruta a cada lugar.

En la siguiente imagen, los puntos A, B y C son lugares que se muestran en la respuesta de la búsqueda:

Para cada lugar de los resultados, la respuesta contiene la duración del viaje y distancia desde el origen de la ruta hasta el lugar, si está disponible.

Nota: Esto es solo una estimación de la información de ruta. Para obtener los detalles reales de la ruta, incluidas las instrucciones paso a paso, usa la API de Routes.

De forma predeterminada, la duración y la distancia del viaje se calculan con la opción TRAFFIC_UNAWARE de la API de Routes. De manera opcional, puedes establecer preferencias de planificación de ruta para tener en cuenta las condiciones de tráfico en tiempo real TRAFFIC_AWARE_OPTIMAL o las condiciones de tráfico en tiempo real con latencia reducida TRAFFIC_AWARE durante los cálculos.

Nota: TRAFFIC_AWARE y TRAFFIC_OPTIMAL solo se aplican a los modos de viaje DRIVE y TWO_WHEELER. Si alguna de las preferencias de enrutamiento especificado con un medio de transporte no admitido, el cálculo del resumen de la ruta se establece de forma predeterminada con el Opción TRAFFIC_UNAWARE. Si se especifica TWO_WHEELER en una no es compatible, la API muestra un resumen de enrutamiento vacío.

Cuando establezcas TRAFFIC_AWARE preferencia de enrutamiento, las rutas se calculan teniendo en cuenta las condiciones del tráfico. Como resultado, la ruta y sus detalles reflejan con mayor precisión las condiciones reales. ya que este aumento en la calidad de los datos se produce en detrimento de la respuesta. se aplican optimizaciones de rendimiento para reducir gran parte de la latencia. Cuando estableces TRAFFIC_AWARE_OPTIMAL preferencia de enrutamiento, las rutas se calculan teniendo en cuenta las condiciones del tráfico, pero no se aplican optimizaciones de rendimiento. En este modo, el servidor realiza una búsqueda más exhaustiva de la red de carreteras para encontrar la ruta óptima.

Información acerca de las rutas, los tramos y los puntos de referencia

Varios componentes conforman una ruta, según los cálculos de la API de Routes:

Una ruta consta de los siguientes componentes:

• Punto de referencia: Para calcular una ruta, especifica, como mínimo, las ubicaciones. del origen y el destino. Tú defines estas ubicaciones como waypoints en la ruta. Los puntos de referencia intermedios son ubicaciones entre el origen y destino por el que deseas que pase la ruta.

• Ruta: Es todo el viaje desde el punto de referencia de origen, por cualquier puntos de referencia intermedios hasta los puntos de referencia de destino. Una ruta consta de una o más legs.

  Cuando pasas una ruta a Text Search, pasas la polilínea codificada de la ruta que muestra la API de Routes. Un objeto codificado polilínea es una lista codificada de puntos de latitud y longitud que te permite representar la polilínea de la ruta como una cadena.

• Etapa: La ruta desde un punto de referencia en una ruta hasta el siguiente en la ruta. Cada etapa consta de uno o más pasos discretos.

  Una ruta contiene un segmento separado para el trayecto desde cada punto de referencia al siguiente. Por ejemplo, si la ruta contiene un solo punto de referencia de origen y un solo punto de referencia de destino, la ruta contiene un solo tramo.

  Por cada punto de referencia adicional que agregues a la ruta después del origen y llamado punto de referencia intermedio, la API agrega un segmento separado.

Para obtener más información sobre rutas y cómo calcular rutas, consulta la sección Rutas API

Calcular el resumen de la ruta con una búsqueda en la ruta

Puedes combinar los cálculos del resumen de planificación de ruta con la búsqueda a lo largo de una ruta. En este caso, Text Search (nueva) muestra la duración del viaje y distancia a cada lugar en la respuesta y, luego, desde cada lugar hasta el el destino de la ruta. Piensa en este cálculo como si fuera un duración y distancia si te desvías de la ruta especificada para viajar a una en los resultados de la búsqueda y luego continúa hasta el destino final.

Por ejemplo, considera la siguiente ruta desde el origen hasta el destino como que calcula la API de Routes. Pasa esta ruta a la API de Text Search (nuevo) junto con tus criterios de búsqueda.

En este ejemplo, la ubicación A es un lugar que se muestra en los resultados de la búsqueda de Text Search (nueva). Para cada lugar de la respuesta, la búsqueda incluye la duración y la distancia necesarias para desviarse a ese lugar como un viaje de dos tramos:

• El primer tramo contiene la duración del viaje y la distancia desde el origen de la ruta hasta el lugar. En este ejemplo, desde el origen hasta el lugar A.
• El segundo tramo contiene la duración y la distancia del viaje desde el lugar hasta el destino de la ruta. En este ejemplo, de la A a la destino.

A partir de la información de la respuesta, puedes calcular el desvío. duración y distancia, donde:

• \(t_{OD}\) es la duración del viaje desde el origen hasta el destino. \(s_{OD}\) es la distancia del viaje entre el origen y el destino.
• \(t_{OA}\) es la duración del viaje desde el origen hasta A; \(s_{OA}\) es la distancia del viaje desde el origen hasta A.
• \(t_{AD}\) es la duración del viaje desde A hasta el destino. \(s_{AD}\) es la distancia del viaje de A al destino

La duración del desvío es la diferencia de duración entre el viaje original (del origen al destino) y el nuevo viaje (del origen al el destino a través de A):

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

La distancia del desvío es la diferencia de distancia entre el viaje original (del origen al destino) y el viaje nuevo (del origen al destino a través de A):

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