Caricare un GeoJSON

GeoJSON è il modo più rapido per portare dati sulla mappa. Gli elementi puntuali vengono importati come segnaposto; poligoni e linee diventano un livello vettoriale che puoi stilizzare.

Caricarlo nell’app

1. Apri la scheda Carica livello nella barra di icone di sinistra e scegli il tuo file .geojson (o .json).
2. Dai al livello un nome e, se vuoi, una descrizione, un colore e una data dell’evento.
3. Carica. I punti compaiono come segnaposto; poligoni e linee vengono resi come livello stilizzato.

Provalo con un esempio

Salva questo file come basel-points.geojson e caricalo — posiziona un singolo segnaposto vicino a Basilea, in Svizzera (è esattamente il file di prova usato dalla suite di test):

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [7.59, 47.56] },
      "properties": { "title": "api-point" }
    }
  ]
}

Poiché l’elemento è un Point, viene importato come segnaposto. Sostituisci la geometria con un Polygon e lo stesso caricamento crea invece un livello vettoriale:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[7.58, 47.55], [7.60, 47.55], [7.60, 47.57], [7.58, 47.57], [7.58, 47.55]]]
      },
      "properties": { "name": "api-polygon" }
    }
  ]
}

Consiglio

Le coordinate GeoJSON sono [longitudine, latitudine] — prima la longitudine. Un segnaposto che finisce nell’oceano al largo dell’Africa occidentale (vicino a 0, 0) di solito significa che la coppia è invertita.

Oppure caricalo tramite l’API

Puoi inviare lo stesso file via HTTP con un token API della stanza. Gli elementi puntuali diventano comunque segnaposto.

cURL

curl -X POST "$API/api/layers/upload" -H "Authorization: Bearer $TOKEN" \
  -F "roomName=$ROOM" -F "layerName=basel-points" -F "file=@basel-points.geojson"

Che cosa ricevi

• Elementi Point → { "markersCreated": N, "markers": [...], "layer": null }
• Elementi Polygon / linea → { "layer": { "name": ..., "featureCount": N, ... } }

I caricamenti vettoriali più grandi restituiscono invece un jobId — interroga GET /api/layers/jobs/<jobId> finché non è completato.

Vedi Avvio rapido dell’API per sapere come ottenere $API, $ROOM e $TOKEN.

Passaggi successivi

Caricare uno ShapefileImporta uno shapefile compresso.