1
|
|
|
# ~*~ coding: utf-8 ~*~ |
2
|
|
|
#- |
3
|
|
|
# OSMAlchemy - OpenStreetMap to SQLAlchemy bridge |
4
|
|
|
# Copyright (c) 2016 Dominik George <[email protected]> |
5
|
|
|
# |
6
|
|
|
# Permission is hereby granted, free of charge, to any person obtaining a copy |
7
|
|
|
# of this software and associated documentation files (the "Software"), to deal |
8
|
|
|
# in the Software without restriction, including without limitation the rights |
9
|
|
|
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
10
|
|
|
# copies of the Software, and to permit persons to whom the Software is |
11
|
|
|
# furnished to do so, subject to the following conditions: |
12
|
|
|
# |
13
|
|
|
# The above copyright notice and this permission notice shall be included in all |
14
|
|
|
# copies or substantial portions of the Software. |
15
|
|
|
# |
16
|
|
|
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
17
|
|
|
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
18
|
|
|
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
19
|
|
|
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
20
|
|
|
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
21
|
|
|
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
22
|
|
|
# SOFTWARE. |
23
|
|
|
# |
24
|
|
|
# Alternatively, you are free to use OSMAlchemy under Simplified BSD, The |
25
|
|
|
# MirOS Licence, GPL-2+, LGPL-2.1+, AGPL-3+ or the same terms as Python |
26
|
|
|
# itself. |
27
|
|
|
|
28
|
|
|
""" Utility code for OSMAlchemy's online functionality. """ |
29
|
|
|
|
30
|
|
|
import overpass |
|
|
|
|
31
|
|
|
|
32
|
|
|
def _generate_overpass_api(endpoint=None): |
33
|
|
|
""" Create and initialise the Overpass API object. |
34
|
|
|
|
35
|
|
|
Passing the endpoint argument will override the default |
36
|
|
|
endpoint URL. |
37
|
|
|
""" |
38
|
|
|
|
39
|
|
|
# Create API object with default settings |
40
|
|
|
api = overpass.API() |
41
|
|
|
|
42
|
|
|
# Change endpoint if desired |
43
|
|
|
if endpoint is not None: |
44
|
|
|
api.endpoint = endpoint |
45
|
|
|
|
46
|
|
|
return api |
47
|
|
|
|
48
|
|
|
def _get_single_element_by_id(api, type, id, recurse_down=True): |
|
|
|
|
49
|
|
|
""" Retrieves a single OpenStreetMap element by its id. |
50
|
|
|
|
51
|
|
|
api - an initialised Overpass API object |
52
|
|
|
type - the element type to query, one of node, way or relation |
53
|
|
|
id - the id of the element to retrieve |
54
|
|
|
recurse_down - whether to get child nodes of ways and relations |
55
|
|
|
""" |
56
|
|
|
|
57
|
|
|
# Construct query |
58
|
|
|
q = "%s(%d);%s" % (type, id, "(._;>;);" if recurse_down else "") |
|
|
|
|
59
|
|
|
|
60
|
|
|
# Run query |
61
|
|
|
r = api.Get(q, responseformat="xml") |
|
|
|
|
62
|
|
|
|
63
|
|
|
# Return data |
64
|
|
|
return r |
65
|
|
|
|