Key:created by: Difference between revisions
Jump to navigation
Jump to search
(DISPLAYTITLE) |
Gravitystorm (talk | contribs) mNo edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 11: | Line 11: | ||
}} |
}} |
||
This tag is used to describe the editor or script which made the changes - similar to a [[wikipedia:user agent]]. Prior to version 0.6 of the API the created_by tag was applied to individual objects (nodes, ways and relations and even segments in earlier protocol versions). However, with the introduction of [[changeset|changesets]] to provide non-geographic "meta data" it makes more sense for the created_by tag to be recorded there. As of September 2009 many nodes, ways or relations still have a created_by tag, but these are slowly disappearing. |
|||
Do not use this tag for nodes, ways, or relations. This behavior is [[Original Changesets and Reverts Proposal 2008#Modifications to the database schema|deprecated in OSM protocol 0.6]]. |
|||
== Values == |
== Values == |
||
| Line 17: | Line 17: | ||
These values are set by software or scripts that create, sometimes edit something. |
These values are set by software or scripts that create, sometimes edit something. |
||
Some examples: |
Some examples: |
||
* JOSM |
* JOSM/1.5 (1788 de) |
||
* Potlatch |
* Potlatch 1.2 |
||
* Merkaartor |
* Merkaartor 0.13 |
||
* YahooApplet |
|||
'''Note:''' You shouldn't edit this value to record your own name. That's recorded as a result of the username used to upload data. |
'''Note:''' You shouldn't edit this value to record your own name. That's recorded as a result of the username used to upload data. |
||
== Guidance to software developers == |
|||
* You ''should'' record a created_by tag on a changeset when saving changes |
|||
* The created_by tag ''may'' contain a revision number, version number or similar. This helps people track down problems if a version of your editor/script has a bug in it. |
|||
* You ''should not'' update the created_by tag on nodes/ways/relations. |
|||
* You ''may'' remove the created_by tag on nodes/ways/relations that you are modifying. This is what JOSM now does. |
|||
* You ''should not'' remove the created_by tag on objects you are not otherwise modifying. If we wanted to remove them in bulk we'd do it some other way. |
|||
Revision as of 14:54, 29 September 2009
 created_by
|
 |
| Description |
|---|
Tag representing Editor/Script which created/(edited) this item.  
|
| Group: Editor keys |
| Used on these elements |
    |
| Status: discardable |
| Tools for this tag |
|
This tag is used to describe the editor or script which made the changes - similar to a wikipedia:user agent. Prior to version 0.6 of the API the created_by tag was applied to individual objects (nodes, ways and relations and even segments in earlier protocol versions). However, with the introduction of changesets to provide non-geographic "meta data" it makes more sense for the created_by tag to be recorded there. As of September 2009 many nodes, ways or relations still have a created_by tag, but these are slowly disappearing.
Values
These values are set by software or scripts that create, sometimes edit something.
Some examples:
- JOSM/1.5 (1788 de)
- Potlatch 1.2
- Merkaartor 0.13
Note: You shouldn't edit this value to record your own name. That's recorded as a result of the username used to upload data.
Guidance to software developers
- You should record a created_by tag on a changeset when saving changes
- The created_by tag may contain a revision number, version number or similar. This helps people track down problems if a version of your editor/script has a bug in it.
- You should not update the created_by tag on nodes/ways/relations.
- You may remove the created_by tag on nodes/ways/relations that you are modifying. This is what JOSM now does.
- You should not remove the created_by tag on objects you are not otherwise modifying. If we wanted to remove them in bulk we'd do it some other way.