Skip to content

Latest commit

 

History

History
74 lines (66 loc) · 1.87 KB

api.md

File metadata and controls

74 lines (66 loc) · 1.87 KB
Raw

back to readme

API

The OSM API provides access to many kind of information in the OSM database. Currently, this module only supports the requests node, way, and relation.

We can access information about a node with the ID 42467507 as follows:

from OSMPythonTools.api import Api
api = Api()
busStop = api.query('node/42467507')

The result is an element of the type OSMPythonTools.element.Element, and easy methods to access its properties exist.

In a similar way, also ways and relations can be accessed:

from OSMPythonTools.api import Api
api = Api()
api.query('way/108402486')
api.query('relation/1539714')

History

The history of an element can be requested easily like follows:

from OSMPythonTools.api import Api
api = Api()
busStop = api.query('node/42467507')
for b in busStop.history():
  print()
  print('ID              ', b.id())
  print('Version         ', b.version())
  print('Number of tags  ', len(b.tags()))
#
# ID               42467507
# Version          1
# Number of tags   4
#
# ID               42467507
# Version          2
# Number of tags   4
#
# ID               42467507
# Version          3
# Number of tags   0
#
# ID               42467507
# Version          4
# Number of tags   5
#
# ID               42467507
# Version          5
# Number of tags   1

Metadata

When requesting data from the Api, the resulting object even contains some metadata about the request:

from OSMPythonTools.api import Api
api = Api()
busStop = api.query('node/42467507')
busStop.apiVersion()
# 0.6
busStop.generator()
# CGImap 0.8.5 (3882970 spike-07.openstreetmap.org)
busStop.copyright()
# OpenStreetMap and contributors
busStop.attribution()
# http://www.openstreetmap.org/copyright
busStop.license()
# http://opendatacommons.org/licenses/odbl/1-0/