Method: searchAlongRoute

Buscar lugares a lo largo de una ruta de viaje

Solicitud HTTP

POST https://mapstools.googleapis.com/v1:searchAlongRoute

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of mutually exclusive fields.
}
Campos
textQuery

string

Obligatorio. Es la búsqueda en lenguaje natural (p.ej., "cargadores de VE", "café").

languageCode

string

Opcional. Es el idioma del resumen y los detalles del lugar. La configuración predeterminada es "en-US".

regionCode

string

Opcional. Es el código de país o región (CLDR) de la ubicación (p.ej., "US").

routingPreference

enum (RoutingPreference)

Opcional. Es la preferencia de ruta opcional que especifica cómo se usan los datos de tráfico. La configuración predeterminada es TRAFFIC_UNAWARE.

includeExtendedDetails

boolean

Opcional. Incluye detalles extendidos del lugar en la respuesta.

Establece este campo en true cuando la solicitud del usuario requiera estadísticas cualitativas enriquecidas, dinámicas en tiempo real o atributos de entidad especializados: - Opiniones cualitativas, opiniones de los clientes y comentarios. - Ofertas específicas, como elementos del menú, platos, especialidades de comida, bebidas o aspectos destacados de la empresa - Atmósfera, decoración interior, estética, ambiente o estado de ánimo cualitativos. - Datos en tiempo real y especificaciones de instalaciones especializadas, políticas/sugerencias para visitantes, tiempos de espera.

Deja false (predeterminado) para las búsquedas de descubrimiento estándar (p.ej., tipos de cocina, tipos de tienda), las búsquedas de ubicación o dirección, la información de contacto, el horario de atención y los metadatos o las comodidades estándar.

Si habilitas este campo, es posible que se genere una latencia más alta.

travelMode

enum (RouteTravelMode)

Opcional. Especifica el medio de transporte que se usa para calcular la ruta y los desvíos. La configuración predeterminada es DRIVE. WALK y BICYCLE solo son compatibles con routeEndpoints. No se admite TRANSIT.

Especificación de la ruta: una ruta existente, un token de ruta o endpoints de origen y destino. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
encodedPolyline

string

Es una cadena de polilínea codificada que representa la ruta. Consulta https://developers.google.com/maps/documentation/utilities/polylinealgorithm

retrievalToken

string

Es un token de recuperación que se devuelve de una llamada anterior a v1.computeRoutes y que representa la ruta.

routeEndpoints

object (RouteEndpoints)

Extremos de ruta explícitos (origen y destino)

Fin de los campos mutuamente excluyentes.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de SearchAlongRouteResponse.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools