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 · Basa Sunda · Baso Minangkabau · bosanski · brezhoneg · català · čeština · corsu · 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 bokmål · 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: