Merge pull request #43 from jgravois/license

adding geoservice licensing and import/guidelines doc

data/core.yaml

@@ -811,15 +811,24 @@ en:
     geoservices: |
       # GeoServices
 
-      The Geoservices import tool allows you to fetch authoritative data (for example [ArcGIS Open Data](https://hub.arcgis.com/pages/open-data)) and verify the accuracy of individual features before importing them into OpenStreetMap.
+      The GeoService tool allows you to fetch live JSON from ArcGIS Open Data](https://hub.arcgis.com/pages/open-data)) and verify the accuracy of individual features before importing them into OpenStreetMap.
+
+      ### Import/Guidelines
+
+      Imports should be planned and executed with more care and sensitivity than other edits, because poor imports can have significant impacts on both existing data and local mapping community. If you'd like to import data in bulk you **must** heed OSM's [Import/Guidelines](http://wiki.openstreetmap.org/wiki/Import/Guidelines) and discuss the plan _in advance_.
+
+      ### License Approval
+
+      Just because you find a public GeoService out in the wild does **not** mean you are allowed to import the data into OpenStreetMap!
+
+      Importing is _only_ allowed if the organization has published it with a PD (Public Domain), CC0 (Creative Commons) or PDDL license or explicit permission has been granted for inclusion in OSM. You can find more information about ODbL license compatibility [here](http://wiki.openstreetmap.org/wiki/Import/ODbL_Compatibility).
 
       ### Sample GeoServices
 
-      * [Madison, WI - bus lines](https://maps.cityofmadison.com/arcgis/rest/services/Public/OPEN_DATA_TRANS/MapServer/18/query?outFields=*&where=1>0&outSR=4326&f=json)
-      * [Norfolk, VA - addresses](http://orfmaps.norfolk.gov/orfgis/rest/services/OpenData/Property_Information/MapServer/0/query?outFields=*&where=1%3D1&outSR=4326&f=json')
-      * [Norfolk, VA - parcels](http://orfmaps.norfolk.gov/orfgis/rest/services/OpenData/Property_Information/MapServer/2/query?outFields=*&where=1%3D1&outSR=4326&f=json)
-      * [Hartford, CT - complex buildings / OSM relations](http://gis1.hartford.gov/arcgis/rest/services/OpenData_Community/MapServer/41/query?outFields=*&where=1%3D1&f=json)
-      * [Stark County / Canton, OH - bike lanes](https://webdmz.starkcountyohio.gov/arcgis/rest/services/RPC/RideStarkOnRoadBikeLane/MapServer/0/query?outFields=*&where=1%3D1)
+      * [Madison, WI - bus lines](https://maps.cityofmadison.com/arcgis/rest/services/Public/OPEN_DATA_TRANS/MapServer/18)
+      * [Norfolk, VA - addresses](http://orfmaps.norfolk.gov/orfgis/rest/services/OpenData/Property_Information/MapServer/0')
+      * [Hartford, CT - complex buildings / OSM relations](http://gis1.hartford.gov/arcgis/rest/services/OpenData_Community/MapServer/41)
+      * [Stark County / Canton, OH - bike lanes](https://webdmz.starkcountyohio.gov/arcgis/rest/services/RPC/RideStarkOnRoadBikeLane/MapServer/0)
 
       ### Editing Process
 
@@ -841,7 +850,24 @@ en:
       * You can add new fields - for example, addresses in Norfolk, Virginia should have ```addr:city=Norfolk``` and ```addr:state=VA``` which are ignored as redundant in the city's data
       * Fields which you do not map are removed from the data before import
 
-      After features have been fetched they need to be reviewed individually prior to being included in an actual changeset.
+      After features have been fetched they need to be reviewed and approved individually prior to being included in an actual changeset.
+
+      ### I've heard of GeoJSON. What is a _GeoService_?
+
+      The [GeoServices](http://geoservices.github.io/index.html) REST specification was developed by Esri and transferred to the [Open Web Foundation](http://www.openwebfoundation.org/faqs/users-of-owf-agreements) in 2010. In iD, we are leveraging its predictable pattern for querying spatial data.
+
+      ```
+      // which US County am I located in?
+      https://tigerweb.geo.census.gov/arcgis/rest/services/TIGERweb/Places_CouSub_ConCity_SubMCD/MapServer/15/query?
+      outFields=*&
+      geometryType=esriGeometryPoint&
+      geometry=-77.069,38.897&
+      inSR=4326&
+      f=geojson
+      ```
+      [live example](https://tigerweb.geo.census.gov/arcgis/rest/services/TIGERweb/Places_CouSub_ConCity_SubMCD/MapServer/15/query?outFields=*&geometryType=esriGeometryPoint&geometry=-77.06930,38.89733&inSR=4326&f=geojson)
+
+      Besides datasets published with Esri tools, the open source project [Koop](http://koopjs.github.io/) makes it possible to use this tool to fetch data from CKAN and Socrata data stores as well.
   intro:
     done: done
     ok: OK

dist/locales/en.json

@@ -669,7 +669,7 @@
             "inspector": "# Using the Inspector\n\nThe inspector is the section on the left side of the page that allows you to\nedit the details of the selected feature.\n\n### Selecting a Feature Type\n\nAfter you add a point, line, or area, you can choose what type of feature it\nis, like whether it's a highway or residential road, supermarket or cafe.\nThe inspector will display buttons for common feature types, and you can\nfind others by typing what you're looking for in the search box.\n\nClick the 'i' in the bottom-right-hand corner of a feature type button to\nlearn more about it. Click a button to choose that type.\n\n### Using Forms and Editing Tags\n\nAfter you choose a feature type, or when you select a feature that already\nhas a type assigned, the inspector will display fields with details about\nthe feature like its name and address.\n\nBelow the fields you see, you can click the 'Add field' dropdown to add\nother details, like a Wikipedia link, wheelchair access, and more.\n\nAt the bottom of the inspector, click 'Additional tags' to add arbitrary\nother tags to the element. [Taginfo](http://taginfo.openstreetmap.org/) is a\ngreat resource for learn more about popular tag combinations.\n\nChanges you make in the inspector are automatically applied to the map.\nYou can undo them at any time by clicking the 'Undo' button.\n",
             "buildings": "# Buildings\n\nOpenStreetMap is the world's largest database of buildings. You can create\nand improve this database.\n\n### Selecting\n\nYou can select a building by clicking on its border. This will highlight the\nbuilding and open a small tools menu and a sidebar showing more information\nabout the building.\n\n### Modifying\n\nSometimes buildings are incorrectly placed or have incorrect tags.\n\nTo move an entire building, select it, then click the '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\n### 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' button in the top\nleft of the interface, and end it either by pressing 'Return' on your keyboard\nor clicking on the first node drawn to close the shape.\n\n### 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 clicking the\ntrash can icon or pressing the 'Delete' key.\n",
             "relations": "# Relations\n\nA relation is a special type of feature in OpenStreetMap that groups together\nother features. For example, two common types of relations are *route relations*,\nwhich group together sections of road that belong to a specific freeway or\nhighway, and *multipolygons*, which group together several lines that define\na complex area (one with several pieces or holes in it like a donut).\n\nThe group of features in a relation are called *members*. In the sidebar, you can\nsee which relations a feature is a member of, and click on a relation there\nto select the it. When the relation is selected, you can see all of its\nmembers listed in the sidebar and highlighted on the map.\n\nFor the most part, iD will take care of maintaining relations automatically\nwhile you edit. The main thing you should be aware of is that if you delete a\nsection of road to redraw it more accurately, you should make sure that the\nnew section is a member of the same relations as the original.\n\n## Editing Relations\n\nIf you want to edit relations, here are the basics.\n\nTo add a feature to a relation, select the feature, click the \"+\" button in the\n\"All relations\" section of the sidebar, and select or type the name of the relation.\n\nTo create a new relation, select the first feature that should be a member,\nclick the \"+\" button in the \"All relations\" section, and select \"New relation...\".\n\nTo remove a feature from a relation, select the feature and click the trash\nbutton next to the relation you want to remove it from.\n\nYou can create multipolygons with holes using the \"Merge\" tool. Draw two areas (inner\nand outer), hold the Shift key and click on each of them to select them both, and then\nclick the \"Merge\" (+) button.\n",
-            "geoservices": "# GeoServices\n\nThe Geoservices import tool allows you to fetch authoritative data (for example [ArcGIS Open Data](https://hub.arcgis.com/pages/open-data)) and verify the accuracy of individual features before importing them into OpenStreetMap.\n\n### Sample GeoServices\n\n* [Madison, WI - bus lines](https://maps.cityofmadison.com/arcgis/rest/services/Public/OPEN_DATA_TRANS/MapServer/18/query?outFields=*&where=1>0&outSR=4326&f=json)\n* [Norfolk, VA - addresses](http://orfmaps.norfolk.gov/orfgis/rest/services/OpenData/Property_Information/MapServer/0/query?outFields=*&where=1%3D1&outSR=4326&f=json')\n* [Norfolk, VA - parcels](http://orfmaps.norfolk.gov/orfgis/rest/services/OpenData/Property_Information/MapServer/2/query?outFields=*&where=1%3D1&outSR=4326&f=json)\n* [Hartford, CT - complex buildings / OSM relations](http://gis1.hartford.gov/arcgis/rest/services/OpenData_Community/MapServer/41/query?outFields=*&where=1%3D1&f=json)\n* [Stark County / Canton, OH - bike lanes](https://webdmz.starkcountyohio.gov/arcgis/rest/services/RPC/RideStarkOnRoadBikeLane/MapServer/0/query?outFields=*&where=1%3D1)\n\n### Editing Process\n\nIn the right menubar, select Map Data (as if you are importing a GPX layer)\n\nClick 'Add GeoService Layer'\n\nUse the iD editor's preset menu on the left to set a target import (for example, a building or address).\n\nPaste the GeoService URL into the text field (it is also possible to add a service to iD by including &geoservice=(escaped URL) in a link URL).\n\nYou'll be asked to confirm that the copyright information for the service grants permission for the data to be included in OpenStreetMap.\n\nSelect 'Load in View' (for large datasets) or 'Load Globally' to control what is fetched.\n\nThe GeoService importer now gives you the option to map the service's fields to OSM tags.\n\n* You can change the name of the tag in your GeoService\n* You can add new fields - for example, addresses in Norfolk, Virginia should have ```addr:city=Norfolk``` and ```addr:state=VA``` which are ignored as redundant in the city's data\n* Fields which you do not map are removed from the data before import\n\nAfter features have been fetched they need to be reviewed individually prior to being included in an actual changeset.\n"
+            "geoservices": "# GeoServices\n\nThe GeoService tool allows you to fetch live JSON from ArcGIS Open Data](https://hub.arcgis.com/pages/open-data)) and verify the accuracy of individual features before importing them into OpenStreetMap.\n\n### Import/Guidelines\n\nImports should be planned and executed with more care and sensitivity than other edits, because poor imports can have significant impacts on both existing data and local mapping community. If you'd like to import data in bulk you **must** heed OSM's [Import/Guidelines](http://wiki.openstreetmap.org/wiki/Import/Guidelines) and discuss the plan _in advance_.\n\n### License Approval\n\nJust because you find a public GeoService out in the wild does **not** mean you are allowed to import the data into OpenStreetMap!\n\nImporting is _only_ allowed if the organization has published it with a PD (Public Domain), CC0 (Creative Commons) or PDDL license or explicit permission has been granted for inclusion in OSM. You can find more information about ODbL license compatibility [here](http://wiki.openstreetmap.org/wiki/Import/ODbL_Compatibility).\n\n### Sample GeoServices\n\n* [Madison, WI - bus lines](https://maps.cityofmadison.com/arcgis/rest/services/Public/OPEN_DATA_TRANS/MapServer/18)\n* [Norfolk, VA - addresses](http://orfmaps.norfolk.gov/orfgis/rest/services/OpenData/Property_Information/MapServer/0')\n* [Hartford, CT - complex buildings / OSM relations](http://gis1.hartford.gov/arcgis/rest/services/OpenData_Community/MapServer/41)\n* [Stark County / Canton, OH - bike lanes](https://webdmz.starkcountyohio.gov/arcgis/rest/services/RPC/RideStarkOnRoadBikeLane/MapServer/0)\n\n### Editing Process\n\nIn the right menubar, select Map Data (as if you are importing a GPX layer)\n\nClick 'Add GeoService Layer'\n\nUse the iD editor's preset menu on the left to set a target import (for example, a building or address).\n\nPaste the GeoService URL into the text field (it is also possible to add a service to iD by including &geoservice=(escaped URL) in a link URL).\n\nYou'll be asked to confirm that the copyright information for the service grants permission for the data to be included in OpenStreetMap.\n\nSelect 'Load in View' (for large datasets) or 'Load Globally' to control what is fetched.\n\nThe GeoService importer now gives you the option to map the service's fields to OSM tags.\n\n* You can change the name of the tag in your GeoService\n* You can add new fields - for example, addresses in Norfolk, Virginia should have ```addr:city=Norfolk``` and ```addr:state=VA``` which are ignored as redundant in the city's data\n* Fields which you do not map are removed from the data before import\n\nAfter features have been fetched they need to be reviewed and approved individually prior to being included in an actual changeset.\n\n### I've heard of GeoJSON. What is a _GeoService_?\n\nThe [GeoServices](http://geoservices.github.io/index.html) REST specification was developed by Esri and transferred to the [Open Web Foundation](http://www.openwebfoundation.org/faqs/users-of-owf-agreements) in 2010. In iD, we are leveraging its predictable pattern for querying spatial data.\n\n```\n// which US County am I located in?\nhttps://tigerweb.geo.census.gov/arcgis/rest/services/TIGERweb/Places_CouSub_ConCity_SubMCD/MapServer/15/query?\noutFields=*&\ngeometryType=esriGeometryPoint&\ngeometry=-77.069,38.897&\ninSR=4326&\nf=geojson\n```\n[live example](https://tigerweb.geo.census.gov/arcgis/rest/services/TIGERweb/Places_CouSub_ConCity_SubMCD/MapServer/15/query?outFields=*&geometryType=esriGeometryPoint&geometry=-77.06930,38.89733&inSR=4326&f=geojson)\n\nBesides datasets published with Esri tools, the open source project [Koop](http://koopjs.github.io/) makes it possible to use this tool to fetch data from CKAN and Socrata data stores as well.\n"
         },
         "intro": {
             "done": "done",