MapasEl mapa de Uruguay, en tu app
Mapa vectorial y fotos aéreas de todo el país, buscador de direcciones, padrones de Catastro, potencial solar y capas en vivo. Datos uruguayos, en castellano, listos para usar.
Qué te da la API
Todo se usa con tu clave (header X-Clave): mapas, fotos aéreas, datos y capas en vivo. Probala gratis un día.
🗺️Mapa vectorial Con clave
Teselas /uruguay/{z}/{x}/{y}.mvt con esquema OpenMapTiles (zoom 0 a 14). Compatibles con MapLibre y Mapbox.
🛩️Fotos aéreas Con clave
Ortofotos de la IDE Uruguay (2017–2018): nacional /orto/nac/…jpg y urbana /orto/urb/…png.
🔎Direcciones Con clave
/api/buscar: direcciones con número, esquinas, calles, barrios, localidades y lugares conocidos.
📐Padrones Con clave
/api/padron: el padrón urbano o rural de un punto, con área y, en los rurales, el valor real.
☀️Sol Con clave
/api/solar: cuánta energía dan los paneles en ese punto y cuánto ahorrás con la tarifa de UTE.
📡Capas en vivo Con clave
Aviones /api/aviones, barcos /api/barcos, focos de calor /api/focos y cámaras /api/camaras.
Cómo conseguir tu clave
Las claves empiezan con muy_ y se mandan en el header X-Clave.
Probala gratis un día
Entrá a tu cuenta y creá una clave de prueba. Dura 1 día, alcanza para armar tu integración.
Ir a mi cuentaElegí un plan
Para usarla en producción, pedí un plan pago con el volumen de consultas que necesitás. Te creamos la clave nosotros.
HablemosUsala desde tu servidor
Mandá X-Clave: muy_… en cada pedido. Tratala como una contraseña: no la pongas en código que corre en el navegador ni la subas a un repositorio.
Consumo
Cada consulta con clave se cuenta por mes. Cada respuesta del padrón trae consultas_usadas.
Errores
401: falta la clave, es inválida o venció. 429: llegaste al límite del mes. 503: el servicio de origen no responde o mandaste demasiados pedidos seguidos.
Formato
Todo es GET, responde JSON en UTF-8 y coordenadas WGS84 (lat, lon). Los errores traen {"ok":false,"error":"…"}.
Empezá en un minuto
Cambiá muy_TU_CLAVE por tu clave.
# Buscar una dirección curl -H "X-Clave: muy_TU_CLAVE" \ "https://mapasuy.com/api/buscar?q=18%20de%20julio%201360,%20montevideo" # Padrón de Catastro en un punto curl -H "X-Clave: muy_TU_CLAVE" \ "https://mapasuy.com/api/padron?lat=-34.9057&lon=-56.1862" # Potencial solar (1 kWp) curl -H "X-Clave: muy_TU_CLAVE" \ "https://mapasuy.com/api/solar?lat=-34.88&lon=-56.17" # Aviones en vivo curl -H "X-Clave: muy_TU_CLAVE" "https://mapasuy.com/api/aviones?lat=-34.8&lon=-56"
// Node 18+ (o cualquier servidor): la clave queda de tu lado, nunca en el navegador. const CLAVE = process.env.MAPASUY_CLAVE; // "muy_…" async function mapasuy(ruta, params) { const url = "https://mapasuy.com" + ruta + "?" + new URLSearchParams(params); const r = await fetch(url, { headers: { "X-Clave": CLAVE } }); const datos = await r.json(); if (!r.ok) throw new Error(r.status + ": " + datos.error); // 401 clave, 429 límite del mes return datos; } const { resultados } = await mapasuy("/api/buscar", { q: "18 de julio 1360, montevideo" }); const { lat, lon } = resultados[0]; const padron = await mapasuy("/api/padron", { lat, lon }); console.log(padron.padron, padron.departamento, padron.area_m2);
<!-- Mapa de Uruguay con MapLibre, con tu clave. El estilo Liberty (OpenFreeMap) usa el esquema OpenMapTiles, así que alcanza con apuntar su fuente "openmaptiles" a las teselas de MapasUY. --> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/maplibre-gl/4.7.1/maplibre-gl.min.css"> <script src="https://cdnjs.cloudflare.com/ajax/libs/maplibre-gl/4.7.1/maplibre-gl.min.js"></script> <div id="mapa" style="height:480px"></div> <script> (async () => { const estilo = await (await fetch("https://tiles.openfreemap.org/styles/liberty")).json(); estilo.sources.openmaptiles = { type: "vector", minzoom: 0, maxzoom: 14, tiles: ["https://mapasuy.com/uruguay/{z}/{x}/{y}.mvt?clave=muy_TU_CLAVE"], attribution: "© OpenMapTiles © OpenStreetMap contributors" }; // Fotos aéreas de la IDE Uruguay (opcional) estilo.sources.foto = { type: "raster", tileSize: 256, minzoom: 6, maxzoom: 18, tiles: ["https://mapasuy.com/orto/nac/{z}/{x}/{y}.jpg?clave=muy_TU_CLAVE"], attribution: "Ortofotos: IDE Uruguay (2017–2018)" }; const i = estilo.layers.findIndex((l) => l.type === "symbol"); estilo.layers.splice(i, 0, { id: "foto", type: "raster", source: "foto", layout: { visibility: "none" } }); const mapa = new maplibregl.Map({ container: "mapa", style: estilo, center: [-56.19, -34.9], zoom: 12 }); // Para ver las fotos: mapa.setLayoutProperty("foto", "visibility", "visible"); })(); </script>
Las teselas y las capas en vivo tienen CORS abierto: las podés pedir directo desde el navegador. Los endpoints con clave pensalos para tu servidor.