IT:JOSM file format

From OpenStreetMap Wiki
Jump to: navigation, search
Lingue disponibili — JOSM file format
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް

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: