ForHosting KIT · Strumenti per sviluppatori

Griglia da riquadro delimitatore

Trasformi un riquadro delimitatore geografico in un reticolo regolare completo senza installare software GIS né programmare cicli sulle coordinate.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Indichi i margini ovest, sud, est e nord in gradi decimali, insieme alla dimensione della cella quadrata. Il risultato riporta le dimensioni della griglia e, per ogni cella, riga, colonna e limiti esatti. Le celle iniziano dall'angolo sud-occidentale, seguono un ordine prevedibile e vengono ritagliate sui margini opposti per coprire esattamente il riquadro richiesto.

Definisca il riquadro e la dimensione delle celle

Parta da un normale riquadro di longitudine e latitudine. Ovest ed est indicano longitudini comprese tra -180 e 180, mentre sud e nord indicano latitudini comprese tra -90 e 90. Est deve essere maggiore di ovest e nord maggiore di sud. La capacità non interpreta un valore ovest maggiore di est come attraversamento dell'antimeridiano, perché ciò renderebbe meno chiari l'ordine delle colonne e il ritaglio dei margini. Imposti cell_size in gradi decimali. Lo stesso valore controlla larghezza e altezza, producendo quadrati angolari e non quadrati di uguale area fisica. Un grado di longitudine copre una distanza minore vicino ai poli. La griglia è quindi adatta a partizioni geografiche trasparenti, tassellazioni, campionamenti e preparazione di viste in cui siano appropriati limiti angolari. Se servono distanze o aree equivalenti, proietti prima l'estensione in un sistema piano idoneo. Scelga una dimensione che garantisca il dettaglio necessario senza generare risultati superflui. Una richiesta che supererebbe 10,000 celle viene rifiutata prima dell'allocazione. Questo limite esplicito mantiene prevedibili il browser, l'API e la successiva elaborazione JSON.

Comprenda copertura, ritaglio e ordinamento

Il reticolo è ancorato esattamente all'angolo sud-occidentale fornito e non a un'origine globale nascosta. La riga zero parte da sud e la colonna zero da ovest. Ogni cella normale si estende di cell_size verso nord ed est. Se la larghezza o l'altezza del riquadro non è un multiplo esatto di tale misura, le celle dell'ultima colonna o riga vengono accorciate e ritagliate su est o nord. Nessuna cella supera il riquadro richiesto e non restano spazi interni. La risposta include rows, columns e cell_count, così Lei può verificare il volume previsto senza ricontare l'array cells. Le celle seguono l'ordine per righe: prima tutte le colonne della riga più meridionale, poi le righe successive verso nord. Ogni record contiene una riga e una colonna con indice iniziale zero, oltre a quattro limiti numerici denominati west, south, east e north. Le coordinate sono normalizzate a dodici cifre decimali per eliminare artefatti come 0.30000000000000004, causati da somme ripetute in virgola mobile. Utilizzi direttamente i limiti restituiti per disegnare rettangoli, costruire poligoni, etichettare tasselli o suddividere altri dati.

Usi un reticolo deterministico nei flussi di dati

Un reticolo generato è utile quando un'area di studio continua deve diventare un insieme di unità rettangolari ripetibili. Un'applicazione cartografica può convertire ogni record di limiti in un anello poligonale. Un flusso di campionamento può assegnare un'attività a ogni riga e colonna. Una pipeline analitica può verificare i punti rispetto alle celle, aggregare record per tassello o suddividere una grande interrogazione in richieste geografiche più piccole. Poiché l'origine coincide con il riquadro fornito, due chiamate producono identificatori corrispondenti soltanto quando west, south, east, north e cell_size sono identici; conservi tali input insieme a ogni riga e colonna memorizzata. L'operazione è deterministica e non usa fornitori di mappe, rete, semi casuali, orologio o stato condiviso. Lo stesso input JSON genera quindi geometria e ordine identici. La capacità restituisce limiti invece di GeoJSON per mantenere la risposta compatta e neutrale rispetto ai formati GIS. Non calcola centroidi, aree, vicini, appartenenza dei punti, intersezioni o trasformazioni di coordinate. Questi passaggi possono essere eseguiti successivamente partendo dai limiti espliciti. L'esecuzione interattiva nel browser è gratuita; ogni richiesta API riuscita applica il prezzo base pubblicato di $0.002.

Suddivida un'estensione cartografica

Crei tasselli stabili per riga e colonna per raggruppare interrogazioni spaziali o distribuire elaborazioni geografiche.

Prepari unità di campionamento

Generi unità rettangolari complete su un'area di studio prima di selezionare o assegnare campioni sul campo.

Disegni un reticolo sovrapposto

Converta ogni record di limiti in un rettangolo o poligono per un livello GIS o una mappa web.

Quanto costa una richiesta API?

Ogni richiesta API riuscita costa $0.002. Lei può anche eseguire gratuitamente lo stesso calcolo deterministico nel browser.

Quale unità utilizza cell_size?

Gradi decimali. Il valore controlla larghezza longitudinale e altezza latitudinale; le celle sono quadrati angolari, non aree terrestri uguali.

Che cosa accade se il riquadro non è divisibile per la dimensione?

L'ultima riga e colonna vengono ritagliate sui limiti nord ed est, garantendo copertura completa senza superare il riquadro.

Il riquadro può attraversare l'antimeridiano?

No. Est deve essere maggiore di ovest. Divida un'estensione che attraversa l'antimeridiano in due riquadri normali.

In quale ordine vengono restituite le celle?

Seguono l'ordine per righe: iniziano a sud-ovest, avanzano verso est e proseguono quindi verso nord.

Perché esiste un limite di 10,000 celle?

Il limite contiene il calcolo e la dimensione della risposta. Aumenti cell_size o divida il riquadro se la richiesta lo supera.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/geo/grid-from-bbox

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/geo/grid-from-bbox \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"west":-2,"south":50,"east":0.5,"north":52,"cell_size":1}'
{
  "west": -2,
  "south": 50,
  "east": 0.5,
  "north": 52,
  "cell_size": 1
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.grid_from_bbox",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_cells10000
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →