Aprende las piezas del mapa antes de conducir la máquina
Bienvenido al taller de mapas de Atlasemoji. Esta página enseña cómo funcionan los mapas — no solo cómo mirarlos, sino cómo construirlos, describirlos, publicarlos y, finalmente, interactuar con ellos mediante herramientas como Developer Workbench y API Explorer.
Para cuando termines esta página, entenderás qué es realmente un mapa, cómo se describe la Tierra usando latitud y longitud, cómo los satélites ayudan a determinar la ubicación, cómo las computadoras describen las formas de los mapas, cómo esas formas se convierten en rutas y áreas, cómo Atlasemoji organiza los objetos del mapa y cómo los desarrolladores pueden trabajar con esos objetos mediante una API.
🌍 Paso 1 — Qué es realmente un mapa
Un mapa es un modelo del mundo. En lugar de mostrar toda la Tierra a tamaño completo, representa lugares usando símbolos.
- Los puntos muestran ubicaciones.
- Las líneas muestran movimiento o conexión.
- Las formas muestran áreas.
Los mapas también combinan capas de información. Un mapa puede mostrar ciudades y carreteras. Otro puede mostrar senderos, migración de fauna, sistemas meteorológicos o una ruta histórica. Los mapas digitales modernos pueden combinar todas esas ideas a la vez.
Por eso el mismo sistema de mapas puede mostrar una ruta de autobús, un límite de incendio forestal, una jugada de fútbol, un sendero o un viaje histórico.
📍 Paso 2 — Latitud y longitud
Cada ubicación en la Tierra puede describirse usando dos números: latitud y longitud.
La latitud mide qué tan al norte o al sur estás.
La longitud mide qué tan al este o al oeste estás.
Ejemplo: Seattle
- Latitud: 47.6062
- Longitud: -122.3321
Juntos, esos dos números identifican un lugar exacto en la Tierra.
🛰 Paso 3 — Cómo saben los teléfonos dónde estás
Mucha gente dice “GPS”, pero GPS es solo un sistema de navegación por satélite.
Los teléfonos y dispositivos de navegación usan GNSS, que significa Global Navigation Satellite System.
Los principales sistemas incluyen:
- GPS — Estados Unidos
- Galileo — Europa
- GLONASS — Rusia
- BeiDou — China
- NavIC — India
- QZSS — Japón
Tu teléfono escucha señales de varios satélites. Midiendo cuánto tardan esas señales en llegar, puede calcular tu posición con mucha precisión.
🗺 Paso 4 — Los mapas necesitan un lenguaje de datos
Las computadoras necesitan una forma consistente de describir lugares. Dos formatos importantes ayudan a hacer eso posible:
- JSON
- GeoJSON
JSON es una manera general de organizar información. GeoJSON es JSON con geografía dentro. Juntos hacen posible describir objetos del mapa de forma clara y consistente.
📦 Paso 5 — JSON: la lista organizada de internet
JSON significa JavaScript Object Notation. Es una forma estructurada de organizar información para que las computadoras puedan intercambiarla fácilmente.
{
"city": "Seattle",
"population": 733000,
"waterfront": true
}Piezas importantes:
- Las llaves
{}contienen un objeto. - Los corchetes
[]contienen una lista. - Los pares clave-valor se ven como
"title": "Seattle".
Muchas APIs usan JSON para intercambiar información.
🌎 Paso 6 — GeoJSON: JSON con geografía
GeoJSON es JSON que describe objetos del mapa. Le dice a un mapa:
- qué tipo de cosa es algo
- dónde está ubicado
Se usan con más frecuencia tres formas:
- Point — una ubicación
- LineString / Polyline — un camino
- Polygon — un área cerrada
GeoJSON es una de las formas más fáciles de convertir ideas sobre lugares en datos que un mapa puede leer.
Intenta cambiar el objeto del mapa
Consejo útil: empieza cambiando el title. Luego cambia las coordinates. Después cambia de punto a línea, o de línea a polígono.
Qué es esto
Qué significa eso
Esto parece GeoJSON, pero la forma está incompleta o es inusual.
Una línea es solo una línea hasta que le añades significado. Así es como la misma aplicación puede mostrar una jugada de fútbol, una ruta de autobús escolar, una ruta de senderismo, una ruta comercial o una falla geológica.
📍 Point
Un punto marca una sola ubicación.
Ejemplos:
- un café
- la cima de una montaña
- un museo
- una parada de autobús
{
"type": "Point",
"coordinates": [-122.3321, 47.6062]
}Regla importante: GeoJSON usa longitud primero, luego latitud.
➖ LineString (Polilínea)
Un LineString es una secuencia de puntos conectados.
Ejemplos:
- un sendero
- una ruta migratoria
- una ruta marítima
- un viaje histórico
{
"type": "LineString",
"coordinates": [
[-122.3321, 47.6062],
[-122.3355, 47.6088],
[-122.3401, 47.6109]
]
}Una línea tiene un comienzo y un final.
🔺 Polygon
Un polígono es una forma cerrada que define un área.
Ejemplos:
- un parque
- un lago
- un límite urbano
- un perímetro de incendio forestal
{
"type": "Polygon",
"coordinates": [[
[-122.3390, 47.6050],
[-122.3300, 47.6050],
[-122.3300, 47.6110],
[-122.3390, 47.6110],
[-122.3390, 47.6050]
]]
}Regla importante: la última coordenada debe coincidir con la primera coordenada para cerrar la forma.
📦 Feature y FeatureCollection
Los objetos GeoJSON suelen aparecer dentro de una Feature.
{
"type": "Feature",
"properties": {
"title": "Seattle",
"emoji": "📍"
},
"geometry": {
"type": "Point",
"coordinates": [-122.3321, 47.6062]
}
}Varias features pueden agruparse dentro de una FeatureCollection. Eso permite que un conjunto de datos incluya lugares, rutas y áreas al mismo tiempo.
🧭 Paso 7 — Puntos de paso y rutas
Un punto de paso es simplemente una ubicación significativa.
Ejemplos:
- un campamento
- la ubicación de un evento histórico
- un punto de medición topográfica
- un capítulo en un viaje
Los puntos de paso conectados pueden formar una ruta.
Esa ruta puede representar un camino migratorio, una ruta comercial de caravanas, un viaje por carretera, un río o una historia que se desarrolla en el tiempo.
🧱 Paso 8 — Geohashing
Cuando los mapas contienen millones de puntos, buscar en toda la Tierra sería lento.
El geohashing resuelve esto dividiendo el planeta en cuadrículas. Cada cuadrado recibe un código corto.
9q8yyLos lugares cercanos suelen compartir prefijos similares. Eso facilita que el software encuentre rápidamente datos cercanos.
🗂 Paso 9 — Manifiestos de Atlasemoji
Atlasemoji organiza los objetos del mapa usando algo llamado manifest.
Un manifest es una descripción estructurada de un objeto del mapa. Un manifest puede generar varias superficies útiles:
- GeoJSON
- un mapa en vivo incrustado
- una vista previa de postal
- una imagen estática
- una respuesta de API
Esto permite que una sola pieza de datos del mapa aparezca en varios contextos útiles.
🖼 Paso 10 — Mapas estáticos vs mapas incrustados
A veces quieres un mapa interactivo en vivo.
Puede aparecer dentro de una página web usando un iframe o una vista de mapa dedicada.
Otras veces quieres una imagen estática.
Por ejemplo:
- una vista previa para redes sociales
- un mapa imprimible
- una postal
Atlasemoji admite tanto superficies en vivo como estáticas.
⚙️ Paso 11 — Hablar con un mapa mediante una API
Una API es una forma de que un software le pida a otra computadora que haga algo.
Por ejemplo:
- crear un punto de paso
- obtener una ruta
- generar GeoJSON
- producir una incrustación de mapa
- renderizar una vista previa estática
Las solicitudes suelen enviarse usando JSON. Las respuestas también suelen volver como JSON.
Swagger, también llamado OpenAPI, proporciona una interfaz visual que permite a los desarrolladores explorar y probar esas solicitudes.
Paso 12 — Antes de tocar la API
Antes de empezar a usar Developer Workbench o Swagger, ayuda saber:
- cómo leer JSON
- cómo distinguir un punto de una polilínea
- que los polígonos deben cerrarse
- que en GeoJSON la longitud suele ir antes que la latitud
- que un objeto del mapa puede tener varias superficies útiles
Una vez que estas ideas encajan, la API se convierte en una herramienta creativa práctica.
🧪 Experimentos con mapas
Prueba pequeñas lecciones interactivas que muestran cómo funcionan los datos del mapa. Cambia una entrada, haz clic en un botón y observa cómo la geometría aparece en un mapa real.
Latitude / Longitude Flip Checker
Humans often say latitude then longitude. GeoJSON uses longitude first. Type a place, then flip it for the map.
Close the Polygon
A polygon must start and end with the same coordinate.
[ [-122.3390, 47.6050], [-122.3300, 47.6050], [-122.3300, 47.6110], [-122.3390, 47.6110], ????? ]
Mini Mission Builder
Build your first real map object. Choose a mission, fill in the blanks, and watch the geometry appear on the map.
Helpful hint: for points, the form uses latitude and longitude separately, but GeoJSON stores them as [longitude, latitude].
- A Feature with Point geometry
- Useful for landmarks, stops, sites, and single events
{
"type": "Feature",
"properties": {
"title": "Treasure",
"emoji": "🏴☠️"
},
"geometry": {
"type": "Point",
"coordinates": [
-122.3321,
47.6062
]
}
}Shape Classifier
- café
- museum
- bus stop
Layer Stack Demo
Maps are built from layers. Big shapes can cover smaller ones depending on which layer is drawn on top.
Geohash Bucket Explorer
Click a bucket. Nearby buckets often share similar prefixes. This is how software narrows the search before looking closely.
🧪 Paso 13 — Misión de práctica
Probemos construir una ruta. Hace mucho tiempo, los comerciantes chumak de Ucrania viajaban hacia el sur para recoger sal. Tu misión es representar ese viaje como un LineString.
- Kyiv: Latitud 50.45, Longitud 30.52
- La estepa: Latitud 48.45, Longitud 32.05
- Minas de sal: Latitud 46.48, Longitud 30.72
Consejo útil: GeoJSON quiere la longitud primero, luego la latitud.
- Invierte las coordenadas al orden de GeoJSON.
- Pega el ejemplo en el editor.
- Mira la línea y explica qué tipo de forma es.
- Da el siguiente paso hacia Developer Workbench.
🚀 Siguiente paso
Una vez que estas ideas te resulten familiares, las siguientes herramientas se vuelven mucho más poderosas.
Atlasemoji proporciona dos herramientas principales para desarrolladores:
Un entorno amigable para experimentar con manifiestos, GeoJSON, incrustaciones, imágenes estáticas y salidas orientadas al mapa.
La interfaz completa de Swagger / OpenAPI para inspeccionar rutas, parámetros, respuestas y el contrato de la API de Atlasemoji.