Simplify language in GPS section, add section on streetlevel photos

This commit is contained in:
Bryan Housel
2017-11-21 10:49:06 -05:00
committed by Minh Nguyễn
parent 3ae7ec8032
commit f48a00ce50
3 changed files with 82 additions and 46 deletions
+63 -33
View File
@@ -674,17 +674,16 @@ en:
You can create, fix, and delete roads with this editor. Roads can be all
kinds: paths, highways, trails, cycle ways, and more - any used segment
is mappable. Roads are the most used type of lines. Other examples of
is mappable. Roads are the most used type of line. Other examples of
lines are waterways, walls, and fences. What you can do with roads
applies to most types of lines.
modifying: |
### Modifying
Often you'll see roads that aren't aligned to the imagery behind them or
Often you'll see roads that aren't aligned to the imagery or
to a GPS track. You can adjust these roads so they are in the correct place.
Click on a road to select it and the pulsing glow will become visible.
All nodes of the road will be shown as small circles.
Click on a road to select it. All nodes of the road will be shown as small circles.
You can drag the nodes to better locations.
You can also create new nodes either by double-clicking on the road or by
moving the small triangles at the midpoints between nodes.
@@ -692,33 +691,37 @@ en:
move: |
### Moving
If you right-click the road the editing menu with several tools appears.
You can select the {move} 'Move' tool, move the entire road at one time, and
then click again to save that movement. You can also simply press the
`M` shortcut key, to start the move.
If you `right-click` the road, the editing menu will appear.
You can select the {move} 'Move' tool to move the entire road at one time.
Then click again to place the road in its new location.
You can also press the `M` shortcut key to move a road.
connect: |
### Connecting
If the road connects to another road, but doesn't properly connect on
the map, you can drag one of its nodes onto the other road in
order to join them. The node will become grey inside.
Having roads connected properly is important for the map
and essential for providing driving directions.
If two road are connected on the map but not in reality,
you can disconnect them with right-click the connecting node and select
the {disconnect} 'Disconnect' tool or press the `D` shortcut key.
If you know that the crossing has traffic lights or crosswalks,
The connections between roads are drawn with grey circles.
The endpoints of a road are drawn with larger white circles if they
don't connect to anything.
To connect a road to another feature, drag one of its nodes onto the
other feature in order to join them.
To disconnect a road from another feature, right-click the connecting
node and select the {disconnect} 'Disconnect' tool or press the `D`
shortcut key.
If you know that the connection has traffic lights or crosswalks,
you can add them by selecting the connecting node and using the
feature editor to select the correct feature's type.
attributes: |
### Attributtes
When a road is selected on the left side the feature editor will show
the type of the road and many attributes like name, speed limit, lines,
When a road is selected, the feature editor in the sidebar will show
the type of the road and many attributes like name, speed limit,
and surface. You can modify fields or even add new ones.
delete: |
@@ -746,16 +749,15 @@ en:
Then click on points along the road so that it follows the right path, according
to satellite imagery or GPS. If the road you are drawing crosses another road, connect
it by clicking on the intersection point. When you're done drawing, double-click
or press 'Return' or 'Enter' on your keyboard.
or press `Return` or `Enter` on your keyboard.
gps:
intro: |
# GPS
# GPS Traces
Collected GPS traces are one valuable source of data for OpenStreetMap. This editor
supports local traces files (file types `.gpx`, `.geojson`, and `.kml`) on your local computer.
You can collect this kind of GPS trace with a number of smartphone applications as well as
personal GPS hardware.
Collected GPS traces are a valuable source of data for OpenStreetMap. This editor
supports `.gpx`, `.geojson`, and `.kml` files on your local computer. You can collect
GPS traces with a smartphone, sports watch, or other GPS device.
For information on how to perform a GPS survey, read
[Mapping with a smartphone, GPS, or paper](http://learnosm.org/en/mobile-mapping/).
@@ -763,16 +765,44 @@ en:
using: |
### Using
To use a GPX track for mapping, drag and drop the GPX file onto the map
editor. If it's recognized, it will be added to the map as a bright purple
line. Click on the {data} 'Map data' menu on the right side to enable,
disable, or zoom to this new GPX-powered layer.
To use a GPS trace for mapping, drag and drop the data file onto the map
editor. If it's recognized, it will be drawn on the map as a bright purple
line. Click on the {data} 'Map data' panel on the side of the map to enable,
disable, or zoom to your GPS data.
The GPX track isn't directly uploaded to OpenStreetMap - the best way to
use it is to draw on the map, using it as a guide for the new features that
you add, and also to [upload it to OpenStreetMap](https://www.openstreetmap.org/trace/create)
The GPS track isn't sent to OpenStreetMap - the best way to use it is to
draw on the map, using it as a guide for the new features that you add.
You can also [upload your GPS data to OpenStreetMap](https://www.openstreetmap.org/trace/create)
for other users to use.
streetlevel:
intro: |
# Street Level Photos
Street level photos provide a ground-truth prespective of an area, useful
for mapping traffic signs, businesses, and other details that you can't
see from satellite and aerial images. The iD editor supports street level
photos from [Mapillary](https://www.mapillary.com) and [OpenStreetCam](https://www.openstreetcam.org).
using: |
### Using
To use streetlevel photos for mapping, click on the {data} 'Map data' panel on the
side of the map to enable or disable the available photo layers.
When enabled, the photo layer will display a line along the sequence of photos.
At higher zooms you will see a circle at each photo location, and at even higher
zooms you will see a viewfield to indicate the direction that the photo was taken.
viewer: |
When you click on one of the photo locations, a photo viewer will appear in the
bottom corner of the map. The photo viewer contains controls to step forward and
backward in the image sequence. It will also show the username of the person who
captured the image, the date it was captured, and a link to view the image on
the original site.
buildings:
intro: |
# Buildings & Areas
@@ -827,8 +857,8 @@ en:
like any other edit, the results are seen by everyone and satellite imagery
is often out of date, so the building could simply be newly built.
You can delete a building by clicking on it to select it, then pressing the 'Delete'
key, or right-clicking it and then using the {delete} 'Delete' tool.
You can delete a building by clicking on it to select it and then pressing the `Delete`
key, or by right-clicking it and then using the {delete} 'Delete' tool.
addresses:
intro: |
+18 -13
View File
@@ -693,32 +693,37 @@
"keyboard": "### Keyboard Shortcuts\n\nYou can view a list of keyboard shortcuts by pressing the `?` key.\n"
},
"editing": {
"intro": "# Editing & Saving\n\nYou can `Click` on a feature once to select it. This will highlight the\nfeature with a pusling glow, and the sidebar will display more details,\nsuch as its name or address.\n\nIf you `Right-click` a map feature, an editing menu will appear, showing\nthe commands that are available, such as rotating, moving, and deleting.\n",
"multiselect": "### Multiselect\n\nYou can `Shift-click` to select several features together. This makes\nit easier to move or delete multiple items.\n\nAnother way to select multiple features is to hold down the `Shift` key,\nthen press and hold the left mouse button, and drag the mouse to draw a\nselection lasso. All of the points inside the lasso area will be selected.\n",
"edit": "### Edit\n\nWhen you make changes like editing roads, building, and places\nthese are stored locally until you save them to the server.\nDon't worry if you make a mistake - until the edits are saved, you\ncan undo changes by clicking the {undo} `Undo` button, and redo changes\nby clicking the {redo} `Redo` button.\n",
"save": "### Save\n\nClick `Save` to finish a group of edits and send them to the OpenStreetMap\nserver. You should remember to save your work frequently!\n\nOn the save screen, you'll have a chance to review what you've done.\nThe editor will perform a basic check for missing data and may offer\nhelpful suggestions and warnings if something doesn't seem right.\n",
"intro": "# Editing & Saving\n\n`Left-Click` on a feature to select it. This will highlight the\nfeature with a pusling glow, and the sidebar will display more details,\nsuch as its name or address.\n\n`Right-click` on a map feature to display the editing menu, which shows\nthe commands that are available, such as rotating, moving, and deleting.\n",
"multiselect": "### Multiselect\n\n`Shift-click` to select several features together. This makes\nit easier to move or delete multiple items.\n\nAnother way to select multiple features is to hold down the `Shift` key,\nthen press and hold the left mouse button, and drag the mouse to draw a\nselection lasso. All of the points inside the lasso area will be selected.\n",
"edit": "### Edit\n\nWhen you make changes to the map, these are stored locally until you save\nthem to the server. Don't worry if you make a mistake - until the edits are\nsaved, you can undo changes by clicking the {undo} `Undo` button, and redo\nchanges by clicking the {redo} `Redo` button.\n",
"save": "### Save\n\nClick `Save` to finish your edits and send them to the OpenStreetMap\nserver. You should remember to save your work frequently!\n\nOn the save screen, you'll have a chance to review what you've done.\nThe editor will perform a basic check for missing data and may offer\nhelpful suggestions and warnings if something doesn't seem right.\n",
"upload": "### Upload\n\nBefore uploading your changes you must enter a\n[changeset comment](https://wiki.openstreetmap.org/wiki/Good_changeset_comments).\nThen click `Upload` to send your changes to OpenStreetMap, where they will be\nmerged into the map and publicly visible to everyone.\n",
"comeback": "If you can't finish your edits in one sitting, for example if your computer\ncrashes or you close the browser tab, your edits are still saved locally.\nYou can come back later (on the same browser and computer), and the\neditor will offer to restore your work.\n"
},
"roads": {
"intro": "# Roads & Lines\n\nYou can create, fix, and delete roads with this editor. Roads can be all\nkinds: paths, highways, trails, cycle ways, and more - any used segment\nis mappable. Roads are the most used type of lines. Other examples of\nlines are waterways, walls, and fences. What you can do with roads\napplies to most types of lines.\n",
"modifying": "### Modifying\n\nOften you'll see roads that aren't aligned to the imagery behind them or\nto a GPS track. You can adjust these roads so they are in the correct place.\nClick on a road to select it and the pulsing glow will become visible.\nAll nodes of the road will be shown as small circles.\nYou can drag the nodes to better locations.\nYou can also create new nodes either by double-clicking on the road or by\nmoving the small triangles at the midpoints between nodes.\n",
"move": "### Moving\n\nIf you right-click the road the editing menu with several tools appears.\nYou can select the {move} 'Move' tool, move the entire road at one time, and\nthen click again to save that movement. You can also simply press the\n`M` shortcut key, to start the move.\n",
"connect": "### Connecting\n\nIf the road connects to another road, but doesn't properly connect on\nthe map, you can drag one of its nodes onto the other road in\norder to join them. The node will become grey inside.\n\nHaving roads connected properly is important for the map\nand essential for providing driving directions.\nIf two road are connected on the map but not in reality,\nyou can disconnect them with right-click the connecting node and select\nthe {disconnect} 'Disconnect' tool or press the `D` shortcut key.\n\nIf you know that the crossing has traffic lights or crosswalks,\nyou can add them by selecting the connecting node and using the\nfeature editor to select the correct feature's type.\n",
"attributes": "### Attributtes\n\nWhen a road is selected on the left side the feature editor will show\nthe type of the road and many attributes like name, speed limit, lines,\nand surface. You can modify fields or even add new ones.\n",
"intro": "# Roads & Lines\n\nYou can create, fix, and delete roads with this editor. Roads can be all\nkinds: paths, highways, trails, cycle ways, and more - any used segment\nis mappable. Roads are the most used type of line. Other examples of\nlines are waterways, walls, and fences. What you can do with roads\napplies to most types of lines.\n",
"modifying": "### Modifying\n\nOften you'll see roads that aren't aligned to the imagery or\nto a GPS track. You can adjust these roads so they are in the correct place.\nClick on a road to select it. All nodes of the road will be shown as small circles.\nYou can drag the nodes to better locations.\nYou can also create new nodes either by double-clicking on the road or by\nmoving the small triangles at the midpoints between nodes.\n",
"move": "### Moving\n\nIf you `right-click` the road, the editing menu will appear.\nYou can select the {move} 'Move' tool to move the entire road at one time.\nThen click again to place the road in its new location.\nYou can also press the `M` shortcut key to move a road.\n",
"connect": "### Connecting\n\nHaving roads connected properly is important for the map\nand essential for providing driving directions.\n\nThe connections between roads are drawn with grey circles.\nThe endpoints of a road are drawn with larger white circles if they\ndon't connect to anything.\n\nTo connect a road to another feature, drag one of its nodes onto the\nother feature in order to join them.\n\nTo disconnect a road from another feature, right-click the connecting\nnode and select the {disconnect} 'Disconnect' tool or press the `D`\nshortcut key.\n\nIf you know that the connection has traffic lights or crosswalks,\nyou can add them by selecting the connecting node and using the\nfeature editor to select the correct feature's type.\n",
"attributes": "### Attributtes\n\nWhen a road is selected, the feature editor in the sidebar will show\nthe type of the road and many attributes like name, speed limit,\nand surface. You can modify fields or even add new ones.\n",
"delete": "### Deleting\n\nIf a road is entirely incorrect - you can see that it doesn't exist in satellite\nimagery and ideally have confirmed locally that it's not present - you can delete\nit, which removes it from the map. Be cautious when deleting features -\nlike any other edit, the results are seen by everyone and satellite imagery\nis often out of date, so the road could simply be newly built.\n\nYou can delete a road by clicking on it to select it, then pressing the 'Delete'\nkey or right-clicking it and then using the {delete} 'Delete' tool.\n",
"create": "### Creating\n\nFound somewhere there should be a road but there isn't? Click the {line} Line\nicon in the top-left of the map or press the shortcut key `2` to start drawing\na line.\n\nClick on the start of the road on the map to start drawing. If the road\nbranches off from an existing road, start by clicking on the place where they connect.\n\nThen click on points along the road so that it follows the right path, according\nto satellite imagery or GPS. If the road you are drawing crosses another road, connect\nit by clicking on the intersection point. When you're done drawing, double-click\nor press 'Return' or 'Enter' on your keyboard.\n"
"create": "### Creating\n\nFound somewhere there should be a road but there isn't? Click the {line} Line\nicon in the top-left of the map or press the shortcut key `2` to start drawing\na line.\n\nClick on the start of the road on the map to start drawing. If the road\nbranches off from an existing road, start by clicking on the place where they connect.\n\nThen click on points along the road so that it follows the right path, according\nto satellite imagery or GPS. If the road you are drawing crosses another road, connect\nit by clicking on the intersection point. When you're done drawing, double-click\nor press `Return` or `Enter` on your keyboard.\n"
},
"gps": {
"intro": "# GPS\n\nCollected GPS traces are one valuable source of data for OpenStreetMap. This editor\nsupports local traces files (file types `.gpx`, `.geojson`, and `.kml`) on your local computer.\nYou can collect this kind of GPS trace with a number of smartphone applications as well as\npersonal GPS hardware.\n\nFor information on how to perform a GPS survey, read\n[Mapping with a smartphone, GPS, or paper](http://learnosm.org/en/mobile-mapping/).\n",
"using": "### Using\n\nTo use a GPX track for mapping, drag and drop the GPX file onto the map\neditor. If it's recognized, it will be added to the map as a bright purple\nline. Click on the {data} 'Map data' menu on the right side to enable,\ndisable, or zoom to this new GPX-powered layer.\n\nThe GPX track isn't directly uploaded to OpenStreetMap - the best way to\nuse it is to draw on the map, using it as a guide for the new features that\nyou add, and also to [upload it to OpenStreetMap](https://www.openstreetmap.org/trace/create)\nfor other users to use.\n"
"intro": "# GPS Traces\n\nCollected GPS traces are a valuable source of data for OpenStreetMap. This editor\nsupports `.gpx`, `.geojson`, and `.kml` files on your local computer. You can collect\nGPS traces with a smartphone, sports watch, or other GPS device.\n\nFor information on how to perform a GPS survey, read\n[Mapping with a smartphone, GPS, or paper](http://learnosm.org/en/mobile-mapping/).\n",
"using": "### Using\n\nTo use a GPS trace for mapping, drag and drop the data file onto the map\neditor. If it's recognized, it will be drawn on the map as a bright purple\nline. Click on the {data} 'Map data' panel on the side of the map to enable,\ndisable, or zoom to your GPS data.\n\nThe GPS track isn't sent to OpenStreetMap - the best way to use it is to\ndraw on the map, using it as a guide for the new features that you add.\n\nYou can also [upload your GPS data to OpenStreetMap](https://www.openstreetmap.org/trace/create)\nfor other users to use.\n"
},
"streetlevel": {
"intro": "# Street Level Photos\n\nStreet level photos provide a ground-truth prespective of an area, useful\nfor mapping traffic signs, businesses, and other details that you can't\nsee from satellite and aerial images. The iD editor supports street level\nphotos from [Mapillary](https://www.mapillary.com) and [OpenStreetCam](https://www.openstreetcam.org).\n",
"using": "### Using\n\nTo use streetlevel photos for mapping, click on the {data} 'Map data' panel on the\nside of the map to enable or disable the available photo layers.\n\nWhen enabled, the photo layer will display a line along the sequence of photos.\nAt higher zooms you will see a circle at each photo location, and at even higher\nzooms you will see a viewfield to indicate the direction that the photo was taken.\n",
"viewer": "\nWhen you click on one of the photo locations, a photo viewer will appear in the\nbottom corner of the map. The photo viewer contains controls to step forward and\nbackward in the image sequence. It will also show the person who captured the image,\nthe date it was captured, and a link to view the image on the original site.\n"
},
"buildings": {
"intro": "# Buildings & Areas\n\nOpenStreetMap is the world's largest database of buildings.\nYou can improve this database. Buildings are the most used type\nof areas, others are residential areas, farmland, forests, lakes, or ponds.\nWhat you can do with buildings applies to most types of areas.\n",
"select": "### Selecting\n\nYou can select a building by clicking on its border. the pulsing glow will\nwill become visible, all nodes will be shown as circles and the\nfeature editor on the left will show the type of the building and\nattributes like name, levels, and address.\n",
"modify": "### Modifying\n\nSometimes buildings are incorrectly placed or have incorrect tags.\nTo move an entire building, select it and press the `M` shortcut key,\nor right-click it and select the {move} 'Move' tool. Move your\nmouse to shift the building, and click when it's correctly placed.\n\nTo fix the specific shape of a building, click and drag the nodes that form\nits border into better places.\n",
"create": "### Creating\n\nOne of the main questions around adding buildings to the map is that\nOpenStreetMap records buildings both as shapes and points. The rule of thumb\nis to _map a building as a shape whenever possible_, and map companies, homes,\namenities, and other things that operate out of buildings as points placed\nwithin the building shape.\n\nStart drawing a building as a shape by clicking the {area} Area button in the top\nleft of the map, and end it either by pressing 'Return' on your keyboard\nor clicking on the first node drawn or clicking again on the last node drawn\nto close the shape.\n\nThen you assign the type of the building to the outline with the feature editor.\nMost buildings are houses, if you're not sure choose the generic Building type.\n",
"delete": "### Deleting\n\nIf a building is entirely incorrect - you can see that it doesn't exist in satellite\nimagery and ideally have confirmed locally that it's not present - you can delete\nit, which removes it from the map. Be cautious when deleting features -\nlike any other edit, the results are seen by everyone and satellite imagery\nis often out of date, so the building could simply be newly built.\n\nYou can delete a building by clicking on it to select it, then pressing the 'Delete'\nkey, or right-clicking it and then using the {delete} 'Delete' tool.\n"
"delete": "### Deleting\n\nIf a building is entirely incorrect - you can see that it doesn't exist in satellite\nimagery and ideally have confirmed locally that it's not present - you can delete\nit, which removes it from the map. Be cautious when deleting features -\nlike any other edit, the results are seen by everyone and satellite imagery\nis often out of date, so the building could simply be newly built.\n\nYou can delete a building by clicking on it to select it and then pressing the `Delete`\nkey, or by right-clicking it and then using the {delete} 'Delete' tool.\n"
},
"addresses": {
"intro": "# Addresses & Points\n\nAddresses are some of the most useful information for the map.\n\nAddress information can be added to OpenStreetMap using a variety of methods,\nsuch as adding a simple point containing an address, adding address information\nto a building, site or other area, or alternatively to an entrance node.\n",
+1
View File
@@ -24,6 +24,7 @@ export function uiHelp(context) {
['help.editing.',['intro','multiselect','edit','save','upload','comeback']],
['help.roads.',['intro','move','connect','attributes','delete','create']],
['help.gps.',['intro','using']],
['help.streetlevel.',['intro','using','viewer']],
['help.buildings.',['intro','select','modify','create','delete']],
['help.addresses.',['intro','nodup','recommendation','points']],
['help.feature_editor.',['intro','select','fields','tags','undo']],