Key:source

From OpenStreetMap Wiki
Jump to: navigation, search
Help
Available languages
Deutsch English Français 日本語 Português do Brasil Русский

source


Description

For indicating the source of information of anything added to the OSM database.

Group

Annotation

Element help

Can be attached on nodesCan be attached on waysCan be attached on areasCan be attached on relations


The source tag is a meta-tag, used for categorising the source of information added to the database. It is not usually used for rendering, but it assists with the verification of data, and informs future editors about the origins of the data they are modifying.

More details about the source can be added using the source_ref tag.

The source tag can be used on all objects, and can also be used on changesets, to specify the source for a group of edits.

It can also be used as a namespace prefix to specify the source of a single attribute. For example, to attribute a source for a name tag, use source:name=photograph, or to indicate the reason for speedlimits (sign, roadmarkings, implicit speedlimits) use source:maxspeed=*.

If the tag already has a namespace prefix (e.g. mf:name=Broadway then use mf.source:name=photograph).

Use of the image tag implies source=photograph. It is not necessary to add a source tag in this case if this is the only source of information for the object. See also Geotagging Source Photos.

If a particular source is later found to infringe copyright (e.g. some source that was believed to be OK is later discovered or ruled to be copyrighted) then it would be possible to easily remove all OSM data originating from that source.

Reliability

The usefulness of the source tag is reduced in areas where data from many sources has been added. After many diverse edits the data may depend on so many sources that it can not be accurately attributed. Also, some editors fail to update the source tag when they edit objects, leaving the source tag reflecting only the original source of the object. Examining the history of the object to see when the tag was added and when it was changed may assist in ensuring the source is correctly understood.


Annotation

Providing further information about tag values for other mappers and in some cases also for users. See Annotations for more details.

Key Value Element Comment Rendering Photo
attribution User defined Node Way Area Relation Attribution to originator if required
description User defined Node Way Area Relation Text that might be viewable to the end user (perhaps using a search system or a map with pop-ups)
email User defined Node Way Area Relation E-Mail address associated with an object
fax User defined Node Way Area Relation Fax number associated with an object
fixme User defined Node Way Area Relation A description to yourself or to other mappers of a (possible) error in the map
image URL Node Way Area Relation Reference to an image (use the "source_ref" key below when the image is referencing the source of the element)
note User defined Node Way Area Relation A note to yourself or to other mappers.
phone User defined Node Way Area Relation Telephone number associated with an object
source User defined Node Way Area Relation
source extrapolation Node Way Area Relation Extension of information from a known source
source historical Node Way Area Relation from out-of-copyright mapping or other historical document
source image Node Way Area Relation photograph or video
source knowledge Node Way Area Relation Local or common knowledge
source survey Node Way Area Relation gpx track or other physical survey
source voice Node Way Area Relation Voice recordings, eg dictaphone
source:name User defined Node Way Area Relation Source used to gather name information eg. for street names
source:ref User defined Node Way Area Relation Reference data source eg. for road numbers
source_ref User defined Node Way Area Relation To record the URI, source reference (eg Landsat) or other link to physical sources
url URL Node Way Area Relation URL associated with an object - Use more precise key like website, image or wikipedia where applicable!
website URL Node Way Area Relation Website associated with an object
wikipedia URL or article title Node Way Area Relation Wikipedia article associated with an object

This table is a wiki template with a default description in English. Editable here.

JOSM Annotation Presets

 <item name="Data Source">
   <label text="Way/Segment/Node Data Source"/>
   <combo key="source" 
          text="Source"
          values="landsat,photograph,local knowledge,common knowledge,dictaphone,extrapolation,<other - please specify>"/>
 </item>
 <item name="Street Name Source">
   <label text="Street Name Source"/>
   <combo key="source:name" 
          text="Source" 
          values="photograph,local knowledge,common knowledge,dictaphone,<other - please specify>"/>
 </item>
 <item name="Road Number Source">
   <label text="Road Number Source"/>
   <combo key="source:ref" 
          text="Source"
          values="photograph,local knowledge,common knowledge,dictaphone,<other - please specify>"/>
 </item>

Most common sources and their meaning

This section lists the most commonly used values of the source key and describes its meaning. If there are more versions (by year, capitization etc.) it is included once only. Most of the fields are blank, fill in what you know.

Value Country(ies) Meaning Website Note
cadastre-dgi-fr fr WikiProject France/Cadastre French catastre maps. Mostly landuse
3dShapes
PGS wordwide Prototype Global Shoreline. Low detail coastline generated from landsat imagery.
YahooJapan/ALPSMAP
KSJ2
bing worldwide Tracing of Microsoft's map service Bing aerial imagery
NRCan-CanVec-7.0
NHD U.S. National Hydrography Dataset. Imported rivers/lakes
cuzk:km cz Manual or semi-automatic tracing of Czech catastral map http://www.cuzk.cz
OSAK
kapor2
survey worldwide see above
SanGIS␣Addresses␣Public␣Domain San Diego U.S. SanGIS government data
Geobase_Import wordwide Geobase data. Mostly place names
HELP␣SERVICE␣-␣REMOTE␣SENSING... cz Import source of some parts of road network in the Czech Republic http://www.bnhelp.cz
dibavod cz Import source of water bodies in the Czech Republic
uhul:ortofoto cz Usually manual tracing of grey-scale aerial imagery by Czech office for economic use of forests
IBGE br IBGE Import. Brazilian federal data

Imports

Many bulk imports have their own unique source tag. Users doing imports are advised to give notice of their intended actions on the Import Mailing List.

Special source tags

When tracing from aerial or satellite imagery, the imagery provider is often given as the source, e.g. yahoo, bing, landsat, etc.

Source tags used by 'Bots


See also

Personal tools
Namespaces
Variants
Actions
site
Toolbox