Sk:Prvky
Ak rozumiete originálu v jazyku angličtina, pomôžte, prosím, tento slovenský preklad dokončiť. Prečítajte si najskôr inštrukcie, ako prekladať túto wiki.
Zdá sa, že na tom nikto nepracuje, takže si to môžete vziať na starosť.
Mapa pozostáva zo základných prvkov uzol (node) a cesta (way). Vlastnosti prvkov sú určené dvojicami klúč (key),hodnota kľúča (value). Všetky používateľské rozhrania na úpravu mapy používajú tieto základné prvky a umožňujú zadávať hodnoty pre kľúče a hodnoty kľúčov.
Základné prvky sú zhodné s ich internou reprezentáciou v databáze (pozri Data Primitives angl.).
Uzol (Node) 
Uzly sú základným stavebným prvkom OSM schémy. Uzly pozostávajú z hodnôt zemepisnej šírky a zemepisnej dĺžky (latitude a longitude). Tretí, voliteľný rozmer, hodnota nadmorskej výšky (altitude) môže byť zaznamenávaná. Kľúč key:ele a uzol môže byť tiež definovaný pre daný layer=* (vrstva) alebo level=* (úroveň).
Mesto, alebo dedina môže byť reprezentovaná uzlom s place=* (miesto) a name=* (názov).
Uzly bez ďalších prepojení na iné prvky sa používajú na popis miest, bodov záujmu a pod. V tomto prípade musí mať uzol priradenú aspoň jednu dvojicu kľúč, hodnota kľúča, ktorá hovorí o tom, ako sa uzol má interpretovať (pozri Sk:Map Features, alebo Map Features angl.).
V niektorých prípadoch majú uzly popri ceste značky (tag); ako power=tower (veža) pre reprezentáciu stĺpu s elektrickým vedením, alebo building=entrance pre určenie vstupu do budovy.
Cesta (Way) 
Cesta je usporiadaný zoznam 2 až 2 000 uzlov, ktoré definujú lomenú čiaru. Cesty sa používajú na reprezentáciu lineárnych objektov, ako sú napríklad rieky alebo cesty. Cestu tvoria uzly, na ktorých má cesta rovnaké vlastnosti napr. rovnaký typ cesty, rovnaké obmedzenie rýchlosti. Neskôr môže byť cesta rozdelená na menšie časti, keď sa zistí, že existujúca cesta nemá rovnaké vlastnosti po celej svojej dĺžke. Cesta musí mať priradenú aspoň jednu značku (dvojicu kľúč: hodnota).
Cestami sú tiež určované hranice plošných objektov, ako sú budovy alebo lesy. V tomto prípade cesta začína aj končí v rovnakom uzle. Takáto cesta sa nazýva Uzavretá cesta alebo Plocha.
V niektorých prípadoch však uzavreté cesty nereprezentujú plochy, ale iba sľučky, ako napr. v prípade kruhového objazdu. Aby sa určil konkrétny význam uzavretej cesty, musia sa preskúmať jej značky (Tags).
Plochy, v ktorých sú diery, alebo ktorých hranice obsahujú viac ako 2 000 uzlov, nie je možné zakresliť jednou cestou. Takéto prípady vyžadujú zložitejšiu dátovú štruktúru – reláciu typu multipolygón.
Relácia (Relation) 
- Hlavný článok: Relácia
Relácia je viacúčelová dátová štruktúra, ktorá popisuje vzťah medzi dvoma alebo viacerými dátovými prvkami (uzlami, cestami a/alebo inými reláciami). Napr.:
- Relácia trasa, ktorá združuje cesty, ktoré spolu tvoria nejakú hlavnú (označenú) cestu (napr. medzinárodná cesta E14), turistickú trasu, alebo autobusovú linku.
- Relácia zákaz odbočenia, ktorá hovorí, že je zakázané v danom mieste odbočiť z jednej cesty na druhú.
- Relácia multipolygón, ktorá popisuje plochu s dierami. Vonkajšiu hranicu tvoria cesty v roli outer a vnútorné diery tvoria cesty v roli inner.
Relácie teda môžu mať rôzne významy. Význam relácie je určený značkami. Obvykle má relácia značku type=*. Ďalšie značky relácie je potom potrebné interpretovať v súvislosti s jej typom.
Relácia je v prvom rade usporiadaný zoznam uzlov, ciest alebo iných relácií. Tieto objekty sa nazvývajú členy relácie.
Každý člen relácie môže mať voliteľne v rámci relácie svoju rolu. Napríklad relácia zákaz odbočenia bude mať členy s rolami 'from' a 'to', ktoré popisujú konkrétne smery zákazu odbočenia.
Každý člen relácie, napr. konkrétna cesta, sa môže v relácii vyskytovať viackrát.
Značka (Tag) 
- Hlavný článok: Tag
Všetky typy dátových prvkov (uzly, cesty a relácie) môžu mať značky (tagy). Tagy popisujú význam konkrétneho prvku, ku ktorému sú pripojené.
Tag pozostáva z dvoch textových polí vo voľnom formáte; „kľúč“ a „hodnota“. Každý z nich sú reťazce Unicode s dĺžkou až 255 znakov. Napríklad higway=residental definuje cestu, ktorej hlavnou funkciou je poskytnúť prístup k domovom ľudí.
Neexistuje žiadny pevný slovník tagov, ale na tejto wiki je zdokumentovaných veľa konvencií (začínajúc stránkou Map Features - Funkcie mapy). Tagy je možné vyhľadávať a vyhodnotiť pomocou aplikácie Taginfo. Ak existuje viac ako jeden spôsob tagovania danej funkcie, pravdepodobne bude najlepšie použiť najbežnejší prístup.
Všeobecné vlastnosti
V rámci databázy OSM ukladáme tieto atribúty pre uzly (nodes), cesty (ways) a relácie (relations). Vaša aplikácia ich nemusí využívať všetky a niektoré výňatky tretích strán vytvorené z údajov OSM ich nemusia všetky reprodukovať
| Názov | Hodnota | Popis |
|---|---|---|
| id | integer (64-bit) | Používa sa na identifikáciu prvku. Typy prvkov majú svoju vlastnú oblasť ID, takže môže existovať uzol (node) s id=100 a cesta (way) id=100, u ktorých je nepravdepodobné, že by spolu súviseli alebo boli geograficky blízko seba.
Kladné (>0) hodnoty sa používajú pre všetky existujúce prvky (a zostanú priradené, keď sa upravia alebo odstránia); záporné hodnoty (<0) sú vyhradené (ich rozsah je obmedzený na aktuálnu sadu zmien a nikdy sa neukladajú do databázy) a používajú sa iba pri odosielaní údajov do databázy OSM na identifikáciu nových objektov, aby sa vytvorili a odkazovali na ne v iných vytvorených alebo upravených objektoch (tzv. server nahradí tieto dočasné identifikátory odoslané editačnou aplikáciou priradením skutočného kladného identifikátora pre každý vytvorený objekt a vráti mapovanie z použitých negatívnych identifikátorov na ich priradené kladné identifikátory). |
| user | character string | Zobrazované meno používateľa, ktorý naposledy upravil objekt (len informatívne a môže byť prázdne). Používateľ môže kedykoľvek zmeniť svoje zobrazované meno (existujúce prvky budú zobrazovať nové používateľské meno bez potreby zmeny verzie). |
| uid | integer | Číselný identifikátor používateľa, ktorý naposledy upravil objekt. Identifikátor používateľa sa nikdy nemení |
| timestamp | W3C standard date and time formats. | Čas poslednej úpravy (napr. "2016-12-31T23:59:59.999Z"). |
| visible | "true" or "false" | Bez ohľadu na to, či je objekt z databázy odstránený alebo nie, ak je visible= "false", potom by mal byť vrátený iba volaniami histórie. |
| version | integer | Verzia úprav objektu. Novovytvorené objekty začínajú na verzii 1 a hodnotu server zvýši, keď klient nahrá novú verziu objektu. Server odmietne novú verziu objektu, ak sa verzia odoslaná klientom nezhoduje s aktuálnou verziou objektu v databáze. |
| changeset | integer | Číslo changesetu, v ktorom bol objekt vytvorený alebo aktualizovaný (podpora 64-bitovej verzie sa odporúča v aplikáciách kvôli kompatibilite s dlhodobým vývojom databázy OSM, ale aplikácie, ktoré iba dopytujú dáta bez ich aktualizácie, môžu tento informatívny atribút ignorovať). |
Okrem toho samozrejme ukladáme značky a tiež úplnú históriu úprav každého prvku.
Viď tiež
| ||||||||||||||||||