Skip to content

Commit

Permalink
Merge pull request #47 from MoenMi/add-osm
Browse files Browse the repository at this point in the history
Add OpenStreetMap in Python
  • Loading branch information
vfscalfani authored Apr 2, 2024
2 parents d3398ee + c51ae77 commit 357d667
Show file tree
Hide file tree
Showing 4 changed files with 1,323 additions and 4 deletions.
6 changes: 6 additions & 0 deletions _toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,12 @@ parts:
- file: src/python/geonames
title: "...in Python"

# OpenStreetMap
- file: src/overview/osm
sections:
- file: src/python/osm
title: "...in Python"

# U.S. Census Geocoding
- file: src/overview/us-census-geocoding
sections:
Expand Down
21 changes: 21 additions & 0 deletions src/overview/osm.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
OpenStreetMap
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

.. sectionauthor:: Michael T. Moen <[email protected]>

Brief Overview
****************

OpenStreetMap (OSM) [#osm1]_ is a worldwide open data mapping service supported by the OpenStreetMap Foundation (OSMF).

The OSM Overpass API allows users to programmatically read data from OSM.

See the API documentation [#osm2]_ for more information on accessing the API and the OSM Copyright and License Page [#osm3]_ for more information on the data's license.

.. rubric:: References

.. [#osm1] `<https://www.openstreetmap.org/>`_
.. [#osm2] `<https://wiki.openstreetmap.org/wiki/Overpass_API>`_
.. [#osm3] `<https://www.openstreetmap.org/copyright>`_
8 changes: 4 additions & 4 deletions src/python/geonames.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,15 @@
"\n",
"by Michael T. Moen\n",
"\n",
"**GeoNames API Documentation:** https://www.geonames.org/export/web-services.html\n",
"**GeoNames API documentation:** https://www.geonames.org/export/web-services.html\n",
"\n",
"**GeoNames API License:** https://www.geonames.org/export/\n",
"**GeoNames API license:** https://www.geonames.org/export/\n",
"\n",
"The GeoNames API is licensed under the Creative Commons' [CC 4.0 license](https://creativecommons.org/licenses/by/4.0/), allowing users to share and adapt the API's data for any purpose, as long as appropriate attribution is given.\n",
"\n",
"*These recipe examples were tested on March 4, 2024.*\n",
"\n",
"**_NOTE:_** The GeoNames API limits users to a maximum of 10000 credits per day and 1000 requests per hour. See [here](https://www.geonames.org/export/credits.html) for a list of how many credits a request to each endpoint uses."
"**_NOTE:_** The GeoNames API limits users to a maximum of 10000 credits per day and 1000 credits per hour. See [here](https://www.geonames.org/export/credits.html) for a list of how many credits a request to each endpoint uses."
]
},
{
Expand Down Expand Up @@ -172,7 +172,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"## 2. Searching with a queries\n",
"## 2. Searching with queries\n",
"\n",
"Queries allow users to search for location at several different levels.\n",
"\n",
Expand Down
Loading

0 comments on commit 357d667

Please sign in to comment.