¿Qué es una polyline codificada de Google?

Es una codificación ASCII compacta de un camino de puntos de latitude/longitude, definida por el formato del algoritmo de polyline codificada de Google. Las Directions y Roads API devuelven las rutas de esta forma porque la cadena es mucho más corta que una lista completa de coordenadas, y se decodifica de vuelta a los puntos exactos.

¿Debería usar precisión 5 o 6 para mi polyline?

Usa 5 para Google Maps y la Google Directions API, y 6 para OSRM, Valhalla, GraphHopper y Mapbox. La precisión 6 conserva un decimal extra, así que una cadena codificada con 6 pero decodificada con 5 cae unas diez veces desviada: haz coincidir siempre la herramienta que creó la polyline.

¿Cómo convierto una polyline codificada en GeoJSON?

Cambia a Decodificar, pega la polyline, y la herramienta produce un GeoJSON LineString Feature junto a la lista de coordenadas simple. El GeoJSON ya usa el orden [longitude, latitude], así que puedes pegarlo directamente en geojson.io, Leaflet o una biblioteca de mapas.

¿Puedo codificar un GeoJSON LineString en una polyline?

Sí. En modo Codificar puedes pegar un GeoJSON LineString, o un Feature o FeatureCollection que envuelva uno, y la herramienta lee sus coordenadas y devuelve la cadena codificada. También puedes pegar líneas «lat, lng» simples si no tienes GeoJSON.

¿Se envían a algún sitio los datos de mi ruta cuando la codifico o decodifico?

No. La codificación y la decodificación se ejecutan por completo en tu navegador usando el algoritmo estándar, así que las coordenadas y las polylines que pegas se procesan en tu dispositivo y nunca se suben a un servidor.

Codificador / decodificador de polyline

Codifica coordenadas en una cadena polyline de Google o decodifica una de vuelta a lat/lng y GeoJSON, directamente en tu navegador. Tu ruta permanece en tu dispositivo.

Las coordenadas y las cadenas polyline que pegas se codifican y decodifican localmente en tu navegador y nunca se suben; nada de lo que introduces se almacena en un servidor.

¿Quieres ver la ruta en un mapa? Abre el Visor de coordenadas en el mapa.

Acerca de Codificador de polyline

Este codificador y decodificador de polyline gestiona el formato del algoritmo de polyline codificada de Google por completo en tu navegador. En modo Codificar, pega un «lat, lng» por línea —o un GeoJSON LineString— y obtén la cadena codificada compacta que las Directions API devuelven para una ruta. En modo Decodificar, pega una polyline codificada y lee de vuelta la lista de coordenadas más un GeoJSON LineString listo para usar que puedes soltar en un mapa. Un conmutador de precisión alterna entre 5 (el valor por defecto de Google Maps) y 6 (usado por OSRM, Valhalla y Mapbox), que es el motivo habitual de que una ruta decodificada caiga en el lugar equivocado. Las polylines empaquetan un camino entero en una cadena ASCII corta, así que esto es práctico cuando una API te entrega una ruta codificada y necesitas coordenadas simples, o al revés. Todo se calcula en tu dispositivo y la ruta que pegas nunca se sube.

Características

Codifica una lista de coordenadas lat/lng en una cadena polyline codificada de Google
Decodifica una polyline de vuelta a coordenadas y a un GeoJSON LineString equivalente
Alterna entre precisión 5 (Google Maps) o 6 (OSRM, Valhalla, Mapbox) en ambos sentidos
Acepta «lat, lng» por línea, o un GeoJSON LineString / Feature como entrada para codificar
Emite un GeoJSON LineString que puedes pegar directamente en un mapa o en geojson.io
Señala una decodificación con precisión errónea, la causa clásica de una ruta desviada unas 10x
Copia la cadena codificada, la lista de coordenadas o el GeoJSON con un clic
Carga un ejemplo canónico para ver el formato antes de pegar tu propia ruta

Cómo usar Codificador de polyline

Elige Codificar para convertir coordenadas en una polyline, o Decodificar para expandir una.
Elige la precisión 5 (Google) o 6 (OSRM/Valhalla) para que coincida con tu fuente de datos.
Pega las coordenadas (un «lat, lng» por línea o un GeoJSON LineString), o una polyline codificada.
Lee la cadena codificada, o la lista de coordenadas y el GeoJSON LineString, en los resultados.
Copia cualquier resultado para tu mapa, tu solicitud a la API o tu archivo de datos.

Ejemplo

Entrada

38.5, -120.2
40.7, -120.95
43.252, -126.453

Salida

_p~iF~ps|U_ulLnnqC_mqNvxq`@

La ruta canónica de tres puntos de la documentación de Google, codificada con precisión 5.

Errores comunes y solución de problemas

Una ruta decodificada aparece desplazada o escalada unas diez veces demasiado lejos. — La precisión no coincide. Google y Google Maps usan 5; OSRM, Valhalla y Mapbox usan 6. Cambia el conmutador de precisión para que coincida con lo que produjo la cadena.
Los puntos decodificados parecen plausibles pero el mapa dibuja la línea en el mar. — Las polylines y esta herramienta guardan primero la latitude, pero las posiciones de GeoJSON son [longitude, latitude]. Usa la salida GeoJSON tal cual en lugar de invertir los pares tú mismo.
La decodificación se detiene con un mensaje «malformed polyline». — La cadena estaba truncada o se copió con caracteres extra. Copia la polyline completa, y elimina las comillas que la rodeen o el escapado de JSON como una barra invertida doblada.

Preguntas frecuentes

¿Qué es una polyline codificada de Google?: Es una codificación ASCII compacta de un camino de puntos de latitude/longitude, definida por el formato del algoritmo de polyline codificada de Google. Las Directions y Roads API devuelven las rutas de esta forma porque la cadena es mucho más corta que una lista completa de coordenadas, y se decodifica de vuelta a los puntos exactos.
¿Debería usar precisión 5 o 6 para mi polyline?: Usa 5 para Google Maps y la Google Directions API, y 6 para OSRM, Valhalla, GraphHopper y Mapbox. La precisión 6 conserva un decimal extra, así que una cadena codificada con 6 pero decodificada con 5 cae unas diez veces desviada: haz coincidir siempre la herramienta que creó la polyline.
¿Cómo convierto una polyline codificada en GeoJSON?: Cambia a Decodificar, pega la polyline, y la herramienta produce un GeoJSON LineString Feature junto a la lista de coordenadas simple. El GeoJSON ya usa el orden [longitude, latitude], así que puedes pegarlo directamente en geojson.io, Leaflet o una biblioteca de mapas.
¿Puedo codificar un GeoJSON LineString en una polyline?: Sí. En modo Codificar puedes pegar un GeoJSON LineString, o un Feature o FeatureCollection que envuelva uno, y la herramienta lee sus coordenadas y devuelve la cadena codificada. También puedes pegar líneas «lat, lng» simples si no tienes GeoJSON.
¿Se envían a algún sitio los datos de mi ruta cuando la codifico o decodifico?: No. La codificación y la decodificación se ejecutan por completo en tu navegador usando el algoritmo estándar, así que las coordenadas y las polylines que pegas se procesan en tu dispositivo y nunca se suben a un servidor.

Herramientas relacionadas

Visor de GeoJSON — Valida GeoJSON y lo previsualiza en un mapa con resumen de features
GPX a GeoJSON — Convierte tracks y waypoints GPX a GeoJSON y de vuelta, en tu navegador.
Conversor de coordenadas — Convierte lat/long entre grados decimales, DMS y DDM
Mapa de latitud y longitud — Ubica coordenadas en un mapa de OpenStreetMap y copia enlaces de Google Maps y geo:.
GeoJSON a CSV — Aplana features de GeoJSON a CSV y reconstruye GeoJSON desde CSV.
WKT a GeoJSON — Convierte geometrías Well-Known Text a GeoJSON y de vuelta, en tu navegador.