ForHosting KIT · Utilidades de desarrollo

Teselas slippy para un cuadro delimitador

Convierta un cuadro delimitador de longitud y latitud en las coordenadas XYZ exactas que utilizan los mapas slippy.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Indique oeste, sur, este, norte y un nivel de zoom; la calculadora devolverá cada tesela intersectada en un orden determinista por filas. También mostrará intervalos compactos de x e y, si el cuadro cruza el antimeridiano y si la latitud polar tuvo que limitarse a Web Mercator. Así podrá reproducir estimaciones de caché, descargas sin conexión, colas de renderizado y comprobaciones de cobertura sin consultar a un proveedor de teselas.

Defina el área geográfica y el zoom

Introduzca el cuadro delimitador como oeste, sur, este y norte en grados decimales WGS84 y elija después un zoom entero de 0 a 22. El sur debe estar por debajo del norte, y oeste y este deben ser diferentes. En la mayoría de los cuadros, oeste es menor que este. Si oeste es mayor, la calculadora interpreta deliberadamente que el área cruza el antimeridiano, de modo que una región en torno a Fiyi o al estrecho de Bering no se extienda por error sobre casi todo el planeta. Para abarcar todas las longitudes, utilice -180 como oeste y 180 como este. El cálculo sigue la convención XYZ habitual de los mapas slippy: x aumenta de oeste a este, y aumenta de norte a sur, y z representa el zoom elegido. Las latitudes situadas fuera del límite de Web Mercator se aceptan como entrada geográfica, pero se proyectan al borde representable más próximo. El resultado señala ese ajuste para aclarar por qué los límites polares no generan filas adicionales.

Comprenda qué teselas limítrofes se incluyen

La lista devuelta contiene las teselas que se solapan con el cuadro en una superficie positiva. No se añade una tesela que solo toque el límite oriental o meridional, lo que evita que un cuadro alineado exactamente con la cuadrícula reciba una columna o fila innecesaria. Los bordes occidental y septentrional seleccionan las teselas inmediatamente interiores. Este tratamiento de bordes semiabiertos resulta especialmente útil para planificar cachés, pues permite procesar cuadros adyacentes sin inflar sistemáticamente ambos lados de cada límite compartido. Cada tesela es un objeto con x, y y z, y el orden sigue las filas de y desde el norte hacia el sur. Dentro de cada fila, x avanza de oeste a este; si se cruza el antimeridiano, primero termina el segmento occidental de x altas y después continúa desde x cero. La respuesta incluye además x_ranges e y_range para consultar o guardar la cobertura compacta sin reconstruirla. El recuento se calcula antes de reservar memoria y se rechazan claramente las solicitudes que superen 100,000 coordenadas.

Utilice las coordenadas en un flujo de caché

Considere el resultado un plan determinista, no contenido cartográfico descargado. La capacidad no realiza solicitudes de red ni conoce proveedores, estilos, extensiones de archivo, tokens de acceso o políticas de uso. Su aplicación puede convertir cada objeto XYZ en una URL del proveedor, un directorio local como z/x/y, una clave de base de datos o una tarea de renderizado. Revise tile_count antes de programar el trabajo para hacer explícitos el almacenamiento, el ancho de banda y las cuotas. Para paquetes sin conexión reproducibles, guarde los límites y el zoom junto con la lista: otra ejecución con la misma entrada producirá los mismos valores y orden. Si una región requiere varios niveles, invoque la capacidad una vez por zoom, pues cada nivel posee su propia cuadrícula y el número de teselas crece con rapidez. Divida las áreas grandes con zoom alto o planifíquelas primero con uno menor. El precio de la API es $0.002 por solicitud; los costes posteriores dependen del proveedor elegido.

Estimar un paquete cartográfico sin conexión

Cuente y enumere los archivos XYZ necesarios para la región elegida por una aplicación de campo antes de descargar imágenes.

Preparar una caché regional de teselas

Genere una cola estable de claves para un área de servicio conocida y entréguela a un calentador de caché autorizado.

Planificar tareas de renderizado

Divida el renderizado de un cuadro en tareas de teselas discretas y ordenadas de forma reproducible para trabajadores independientes.

¿Qué convención de teselas utiliza?

Utiliza coordenadas XYZ de mapas slippy: x crece hacia el este, y hacia el sur, y z es el nivel de zoom.

¿Puede el cuadro cruzar el antimeridiano?

Sí. Establezca oeste mayor que este; el resultado cubrirá primero el segmento occidental de x altas y después el oriental de x bajas.

¿Por qué se limitan las latitudes polares?

Web Mercator estándar termina aproximadamente en 85.0511 grados norte y sur. Las entradas que lo superen se asignan a la fila disponible más próxima.

¿Descarga o almacena teselas de mapa?

No. Solo devuelve coordenadas y no utiliza la red. Usted elige la fuente y debe respetar las condiciones del proveedor.

¿Cuánto cuesta una solicitud?

El precio de la API es $0.002 por solicitud. El proveedor, el almacenamiento o el renderizado pueden generar costes aparte.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/geo/tiles-in-bbox

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/geo/tiles-in-bbox \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"west":-74.02,"south":40.7,"east":-73.98,"north":40.73,"zoom":12}'
{
  "west": -74.02,
  "south": 40.7,
  "east": -73.98,
  "north": 40.73,
  "zoom": 12
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.tiles_in_bbox",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

min_zoom0
max_zoom22
max_tiles100000
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →