Se usó la API de Cloud Translation para traducir esta página.

Solicita polilíneas de rutas

La codificación de polilínea es un algoritmo de compresión con pérdida que te permite almacenar una serie de coordenadas, como una ruta, como una sola string. El proceso de codificación convierte un valor binario en una serie de códigos de caracteres para caracteres ASCII con el esquema de codificación base64. Para obtener una descripción completa del proceso de codificación, consulta Formato del algoritmo de polilínea codificada.

Los métodos computeRoutes (REST) y ComputeRoutes (gRPC) muestran la ruta representada por una polilínea como parte de la respuesta. Estas API muestran dos tipos de polilíneas:

La polilínea básica (predeterminada) representa una ruta, pero sin información de tráfico incorporada en la polilínea. Las solicitudes que muestran una polilínea básica se facturan con la tarifa básica de Routes. Obtén más información sobre la facturación de la API de Routes.
polilínea polilínea de tráfico: Contiene información sobre las condiciones de tráfico a lo largo de la ruta. Las condiciones de tráfico se expresan en categorías de velocidad (NORMAL, SLOW, TRAFFIC_JAM) aplicables a un intervalo determinado de la polilínea. Las solicitudes de polilíneas adaptadas al tráfico se facturan con la tarifa Routes Preferred. Obtén más información sobre la facturación de la API de Routes.

Para obtener más información sobre las polilíneas, consulta lo siguiente:

Cómo configurar la calidad frente a la latencia para obtener información sobre la configuración de la calidad de la polilínea.
El formato de algoritmo de polilínea codificada describe el algoritmo para codificar una polilínea.
La utilidad de codificador de polilínea interactiva te permite crear polilíneas codificadas en una IU o decodificar polilíneas para mostrarlas en un mapa. Por ejemplo, usa esta utilidad para decodificar una polilínea creada por el siguiente código.

Nota: Los caracteres especiales en las polilíneas que muestra la API de REST tienen escape de JSON. Para mostrar estas polilíneas en la utilidad de codificador de polilínea interactiva, primero debes escaparlas. Hay muchas utilidades disponibles para ejecutar un escape de JSON, como Freeformatter.

Solicita una polilínea básica para una ruta, un tramo o un paso

Una polilínea se representa con un objeto Polyline (REST) o Polyline (gRPC). Puedes mostrar una polilínea en la respuesta a nivel de la ruta, la etapa y el paso.

Especifica qué polilínea se debe mostrar con la máscara de campo de respuesta:

A nivel de la ruta, muestra una polilínea en la respuesta mediante la inclusión de routes.polyline en la máscara del campo de respuesta.
En el nivel del tramo, se muestra una polilínea en la respuesta de cada etapa de la ruta mediante el objeto routes.legs.polyline.

Nota: Cada etapa corresponde al viaje entre dos puntos de referencia cuando via es falso para que el punto de referencia indique una parada en la ruta. Por ejemplo, una ruta sin puntos de referencia intermedios tiene un solo segmento. Una ruta que incluye un punto de referencia intermedio con una parada tiene dos tramos. Una ruta que incluye un punto de referencia intermedio con via configurado como verdadero tiene una etapa.
En el nivel del paso, muestra una polilínea en la respuesta de cada paso del tramo incluyendo routes.legs.steps.polyline.

Por ejemplo, a fin de mostrar una polilínea para toda la ruta, para cada etapa y para cada paso de cada tramo, haz lo siguiente:

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline,routes.legs.steps.polyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Esta solicitud muestra la siguiente respuesta, que incluye la polilínea de la ruta, de cada tramo de la ruta y de cada paso del tramo:

{
  "routes": [
    {
      "legs": [
        {
          "polyline": {
              "encodedPolyline": "ipkcFfich...@Bs@?A?O?SD{A@o@B}@I?qA?_AA_@@_@?"
          }
        },
          "steps": [
              {
                  "polyline": {
                      "encodedPolyline": "kclcF...@sC@YIOKI"
                  }
              },
              {
                  "polyline": {
                      "encodedPolyline": "wblcF~...SZSF_@?"
                  }
              },
              ...
      ],
      "distanceMeters": 56901,
      "duration": "2420s",
      "polyline": {
        "encodedPolyline": "ipkcFfich...@Bs@?A?O?SD{A@o@B}@I?qA?_AA_@@_@?"
      }
    }
  ]
}

Debido a que esta solicitud solo contiene un origen y un destino, la ruta que se muestra solo contiene un único segmento. Por lo tanto, la polilínea del tramo y la ruta son las mismas.

Si agregas un punto de referencia intermedio a la solicitud, la ruta que se muestra contiene dos segmentos:

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    { "address": "450 Serra Mall, Stanford, CA 94305, USA"},
  ],
  "travelMode": "DRIVE",
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Esta solicitud muestra dos etapas, cada una con una polilínea única y una polilínea para toda la ruta:

{
  "routes": [
    {
      "legs": [
        {
          "polyline": {
            "encodedPolyline": "kclcFfqchV?A...?I@G?GAECCCEKICBAFG"
          }
          "steps": [
            {
                "polyline": {
                    "encodedPolyline": "kclcFfqch...YIOKI"
                }
            },
        ...
        },
        {
          "polyline": {
            "encodedPolyline": "ojmcFtethV?K...QOYQOGA?_@MUG[Ga@G"
          }
          "steps": [
            {
                "polyline": {
                    "encodedPolyline": "uypeFbo`jVgJq...PoBiC"
                }
            },
        ...
        }
      ],
      "distanceMeters": 68403,
      "duration": "3759s",
      "polyline": {
          "encodedPolyline": "kclcFfqchV?A?CBKF[Ha...?GAECCCEKICBAFGJEBE"
      }
    }
  ]
}

Cómo configurar el tipo de codificación de polilínea

Usa la opción de solicitud polylineEncoding para controlar el tipo de polilínea. La propiedad polylineEncoding especifica cómo codificar la polilínea como ENCODED_POLYLINE (predeterminada), lo que significa que se usa el algoritmo de codificación de polilínea, o GEO_JSON_LINESTRING, lo que significa que se usa el formato GeoJSON LineString.

Por ejemplo, en el cuerpo de la solicitud:

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "travelMode": "DRIVE",
  "polylineEncoding": "ENCODED_POLYLINE"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Solicita una polilínea optimizada para el tráfico

Los ejemplos anteriores muestran polilíneas básicas, es decir, polilíneas sin información sobre el tráfico. Además, puedes solicitar que la polilínea contenga información sobre el tráfico de la ruta y de cada tramo de la ruta.

Las polilíneas que tienen en cuenta el tráfico contienen información sobre las condiciones del tráfico a lo largo de la ruta. Las condiciones de tráfico se expresan en términos de categorías de velocidad (NORMAL, SLOW, TRAFFIC_JAM) para un intervalo determinado de la polilínea de respuesta. Los intervalos se definen según los índices de sus puntos de polilínea iniciales (inclusivos) y finales (exclusivos).

Por ejemplo, la siguiente respuesta muestra el tráfico NORMAL entre los puntos de polilínea 2 y 4:

{
  "startPolylinePointIndex": 2,
  "endPolylinePointIndex": 4,
  "speed": "NORMAL"
}

Para realizar una solicitud a fin de calcular una polilínea optimizada para el tráfico, configura las siguientes propiedades en la solicitud:

Establece el campo de array extraComputations en TRAFFIC_ON_POLYLINE para habilitar el cálculo del tráfico.
Establece travelMode en DRIVE o TWO_WHEELER. Las solicitudes para cualquier otro medio de transporte muestran un error.
Especifica la preferencia de enrutamiento TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL en la solicitud. Para obtener más información, consulta Cómo configurar la calidad frente a la latencia.
Establece una máscara de campo de respuesta que especifique para mostrar las propiedades de respuesta:
- A nivel de la ruta, muestra toda la información de viaje en la respuesta mediante la inclusión de routes.travelAdvisory en la máscara del campo de respuesta. Para mostrar solo la información del tráfico, especifica routes.travelAdvisory.speedReadingIntervals
- A nivel del tramo, muestra toda la información de viaje en la respuesta de cada etapa de la ruta. Para ello, incluye el valor routes.legs.travelAdvisory. Para mostrar solo la información del tráfico, especifica routes.legs.travelAdvisory.speedReadingIntervals.

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TRAFFIC_ON_POLYLINE"],
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline,routes.legs.polyline,routes.travelAdvisory,routes.legs.travelAdvisory' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ejemplo de respuesta para una polilínea que tiene en cuenta el tráfico

En la respuesta, los datos de tráfico se codifican en la polilínea y se incluyen en el campo travelAdvisory del tipo RouteLegTravelAdvisory (cada etapa) y el objeto RouteTravelAdvisory (ruta).

Por ejemplo:

{
  "routes": [
    {
      "legs": {
        "polyline": {
          "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
        },
        // Traffic data for the leg.
        "travelAdvisory": {
          "speedReadingIntervals": [
            {
              "endPolylinePointIndex": 1,
              "speed": "NORMAL"
            },
            {
              "startPolylinePointIndex": 1,
              "endPolylinePointIndex": 2,
              "speed": "SLOW"
            },
            {
              "startPolylinePointIndex": 2,
              "endPolylinePointIndex": 4,
              "speed": "NORMAL"
            }
          ] 
        }
      },
      "polyline": {
        "encodedPolyline": "}boeF~zbjVAg@EmB`GWHlD"
      },
      // Traffic data for the route.
      "travelAdvisory": {
        "speedReadingIntervals": [
          {
            "endPolylinePointIndex": 1,
            "speed": "NORMAL"
          },
          {
            "startPolylinePointIndex": 1,
            "endPolylinePointIndex": 2,
            "speed": "SLOW"
          },
          {
            "startPolylinePointIndex": 2,
            "endPolylinePointIndex": 4,
            "speed": "NORMAL"
          }
        ] 
      }
    }
  ]
}

RouteTravelAdvisory y RouteLegTravelAdvisory incluyen un campo de array llamado speedReadingIntervals que contiene información sobre la velocidad del tráfico. Cada objeto del array está representado por un objeto SpeedReadingInterval (REST) o SpeedReadingInterval (gRPC).

Un objeto SpeedReadingInterval incluye la lectura de velocidad en un intervalo de ruta, como NORMAL, SLOW o TRAFFIC_JAM. El arreglo completo de objetos cubre toda la polilínea de la ruta sin superposición. El punto de inicio de un intervalo especificado es el mismo que el punto final del intervalo anterior.

Cada intervalo se describe por su startPolylinePointIndex, su endPolylinePointIndex y la categoría de velocidad correspondiente. Observa que la falta del índice de inicio dentro del intervalo corresponde al índice 0 de acuerdo con las prácticas de proto3.

Los valores startPolylinePointIndex y endPolylinePointIndex no siempre son consecutivos. Por ejemplo:

{
  "startPolylinePointIndex": 2,
  "endPolylinePointIndex": 4,
  "speed": "NORMAL"
}

En este caso, las condiciones de tráfico eran las mismas del índice 2 al índice 4.

Cómo renderizar polilíneas optimizadas para el tráfico con el SDK de Maps

Te recomendamos que muestres polilíneas con información sobre el tráfico en el mapa mediante las diversas funciones que ofrecen los SDK de Google Maps, como coloración, trazos y patrones personalizados a lo largo de los tramos de polilínea. Si deseas obtener más detalles sobre el uso de polilíneas, consulta Funciones de polilínea para Android y Funciones de polilínea para iOS.

Ejemplo de renderización de polilínea

Los usuarios del SDK de Maps tienen la oportunidad de definir una lógica de asignación personalizada entre las categorías de velocidad y los esquemas de renderización de polilíneas. A modo de ejemplo, podríamos decidir mostrar la velocidad "NORMAL" como una línea gruesa azul en el mapa, mientras que la velocidad "SLOW" podría mostrarse como una línea naranja gruesa, y así sucesivamente.

Los siguientes fragmentos agregan una polilínea azul gruesa con segmentos geodésicos desde Melbourne hasta Perth. Para obtener más información, consulta Cómo personalizar la apariencia (para Android) y Cómo personalizar la polilínea (para iOS).

Android

Java

Polyline line = map.addPolyline(new PolylineOptions()
    .add(new LatLng(-37.81319, 144.96298), new LatLng(-31.95285, 115.85734))
    .width(25)
    .color(Color.BLUE)
    .geodesic(true));

Kotlin

val line: Polyline = map.addPolyline(
  PolylineOptions()
    .add(LatLng(-37.81319, 144.96298), LatLng(-31.95285, 115.85734))
    .width(25f)
    .color(Color.BLUE)
    .geodesic(true)
)

iOS

Objective‑C

GMSMutablePath *path = [GMSMutablePath path];
[path addLatitude:-37.81319 longitude:144.96298];
[path addLatitude:-31.95285 longitude:115.85734];
GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];
polyline.strokeWidth = 10.f;
polyline.strokeColor = .blue;
polyline.geodesic = YES;
polyline.map = mapView;

Swift

let path = GMSMutablePath()
path.addLatitude(-37.81319, longitude: 144.96298)
path.addLatitude(-31.95285, longitude: 115.85734)
let polyline = GMSPolyline(path: path)
polyline.strokeWidth = 10.0
polyline.geodesic = true
polyline.map = mapView