Beginners Guide 1.3

From OpenStreetMap Wiki
(Redirected from Ca:Beginners Guide 1.3)
Jump to: navigation, search
Available languages — Beginners Guide 1.3
· 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 · Tagalog · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · भोजपुरी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · བོད་ཡིག · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ‎ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 中文(繁體)‎ · 吴语 · 粵語 · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް
  Get help   About OpenStreetMap   Browsing   How to contribute   Contribute map data   Editors   Glossary   Beginners' guide ±

Editing Overview

Here is how OSM data editing works.

  • Optionally, you go outdoors and collect information.
  • You edit the OSM data using an editor. Once you are happy with your changes, you upload them to the OSM servers in what's known as a "changeset".
  • Various consumers (services, companies, navigation apps, users, researchers, etc.) download the data from the OSM servers and use it.
  • Many consumers convert the raw data into tile maps. This is known as rendering.

Understanding OSM Data

The elements

Let's talk about the structure of the OSM data. The data is made of elements.

  • Node Nodes are dots used to that mark locations. Nodes can be seperate or can be connected.
  • Way Ways are a connected line of nodes. It is used to create roads, paths, rivers, and so on.
  • Closed way Closed ways are ways that form a closed loop. Usually forms an area.
  • Area Areas are closed ways which are also filled. An area is usually implicitly implied when making a closed way.
  • Relation Relation can be used to create more complex shapes, or to represent elements that are related but not physically connected. We won't get into this now. See the "advanced topics" section for more info.

All these elements can carry tags.

Tags

An element can have tags. A tag is a key=value pair describing what the element is. For instance, mapping a mobile phone store can be done by creating a node, and adding the following tags: shop=mobile_phone. name=John Smith's phone centre. Here are some more examples:

Some editors, including JOSM and ID, have "presets". The user clicks a button and fills a form, and the editor applies the proper tags to the element automatically. This can be far easier for beginners than working with raw tags, but it doesn't cover all existing tags. Please note that as beginner, you don't have to dig too deep into precise tagging schemes thanks to presets, but knowing a bit about tags is very helpful. Feel free to skim through the rest of this section if you're in a hurry.

Most tag keys and values have their own dedicated page on this Wiki that explains how to use them. Search for what you're trying to map using the search bar and you may find the appropriate tag. If you fail to find it, feel free to ask others for help. Some tags can be used for nodes, ways, and relations. Others can only be used on nodes or ways. A tag's page usually explains this. Also, please note that some countries have local tagging conventions. Consult your country's Wiki page.

Tagging rules and conventions change with time. These conventions are decided by the community through common usage, voting, and discussion at talk:tagging. Here is a list of important tag keys that you should be aware of. Most editors have helpful presets that will help you get started easily, without knowing tags in depth. But knowing the basics certainly helps.

Note that many keys, like Key:building or Key:amenity will make OSM automatically assume a closed way should be an area. It is relatively uncommon to create an area explicitly (using an area=yes tag on a closed way).

Important tag keys

  • Key:highway - For tagging highways, roads, paths, footways, cycleways, bus stops, etc.
  • Key:place - Used for tagging countries, cities, towns, villages, etc.
  • Key:amenity - Used for tagging useful amenities like restaurants, drinking water spots, parking lots, etc.
  • Key:shop - Used for tagging shops that you buy products from.
  • Key:building - Used for tagging buildings.
  • Key:landuse - Used for tagging land being used by humans.
  • Key:natural - Used for tagging natural land like forests.

Learn the basics of an editor

Adding, removing, and editing OSM elements requires an editor. There are many editors. You should start with one of the three major editors. Before continuing this guide, please choose an editor, and at least learn the usage basics. Information about each editor can be found by clicking on it. The iD editor and Potlach 2 have built-in usage guides. JOSM has a beginner guide here.


ID.svg
iD is the easy to use editor found per default on the "Edit" button of the OpenStreetMap homepage, and is ideal for quick editing contributions. It runs in your browser and downloads data automatically as you look around.
Potlatch2logo.png
Potlatch 2 is the precursor to iD, still used by quite a few people, and still available under the 'edit' button drop-down ("▼"). Requires Flash.
JOSM Logo 2014.svg
JOSM is a highly expandable standalone Java desktop application which allows fluid zooming, panning, and editing of a locally stored dataset, before uploading changes in a batch.


There are also smart-phone editing-capable apps like OsmAnd and Maps.Me. These allow you to survey and the edit the map on the spot, but they are less convenient and less flexible than a desktop editor and won't be discussed in this guide.

Now that you know the basics of how to use an editor, it's time to learn some mapping and data collection techniques.

Next step

See also