IT:JOSM file format

Il formato file JOSM è utilizzato da JOSM, se e quando l'utente salva / carica i dati su file. I file JOSM hanno l'estensione .osm, e il formato è molto simile agli estratti di Planet.osm o al risultato di un richiesta di una bbox al server, con alcune aggiunte. Si tratta di un formato sia di archiviazione che di modifica dei formati di file, che oltre a memorizzazione i dati scaricati dal server contiene anche le modifiche effettuate dall'utente sin dal download.

Esempio

<?xml version='1.0' encoding='UTF-8'?>
<osm version='0.5' generator='JOSM'>
  <bounds minlat='51.5076478723889' minlon='-0.127989783553507' maxlat='51.5077445145483' maxlon='-0.127774884645096' origin='OpenStreetMap server' />
  <node id='26821100' timestamp='2009-02-16T21:34:57+00:00' user='dankarran' visible='true' lat='51.5077286' lon='-0.1279688'>
    <tag k='created_by' v='Potlatch 0.10f' />
    <tag k='name' v='Nelson&apos;s Column' />
    <tag k='tourism' v='attraction' />
    <tag k='monument' v='statue' />
    <tag k='historic' v='monument' />
  </node>
  <node id='-1' visible='true' lat='51.507661490456606' lon='-0.1278000843634869' />
  <node id='346364767' action='delete' timestamp='2009-02-16T21:34:44+00:00' user='dankarran' visible='true' lat='51.5076698' lon='-0.1278143' />
</osm>

Il formato è quasi esattamente uguale all'output del server, con piccole modifiche:

• Aggiunta di una o più elementi bound (confine) che indicano i limiti dei riquadri dei download che hanno generato questi dati (se conosciuti). Inoltre, questi hanno anche un attributo origine che indica al server i dati di provenienza.
• Elementi che possono avere un attributo azione che può assumere uno dei valori: modifica o elimina. Con modifica si indica che si dovrebbe sostituire la vecchia versione di questo elemento.
• La creazione è indicata mediante l'uso di un numero negativo nell'attributo id. Questo ID negativo è allo stesso tempo un valore segnaposto che può essere utilizzato in altre parti del file per un oggetto dipendente. Gli ID devono essere ripartiti in modo univoco in tutto il documento.

A differenza di altri formati di file, l'ordine degli oggetti è per tipo invece che per ordine attuale dei cambiamenti. Il risultato è un file diverso ed auto-consistente, quindi sarà sempre possibile riordinare le modifiche in modo tale che sia preservata l'integrità dei riferimenti.

utilizzo e destinazione

Il formato file JOSM è destinato alle seguenti tipologie di clients:

• editors
• batch-scripts

non è adatto per

• dispositivi con capacità di memorizzazione molto limitata
• dispositivi con memoria limitata

è ottimizzato per:

• uso generale

Questo protocollo è supportato da i seguenti clients:

• JOSM
• Osmosis