A Python client for the Mapzen APIs.
- Forward geocoding to find a place by searching for an address or name
- Reverse geocoding to find what is located at a certain coordinate location
- Autocomplete to give real-time result suggestions without having to type the whole location
- Global coverage with prioritized local results
pip install git+https://github.com/duydo/python-mapzen.git
from mapzen.api import MapzenAPI
api_key = 'your api_key'
api = MapzenAPI(api_key)
# Search a specific location
# r = api.search('Ho Chi Minh')
# Search within Vietnam
r = api.search(
'Ho Chi Minh',
boundary_country='VN'
)
# Search within Vietnam and place types: country, region or locality (towns, hamlets, cities)
r = api.search(
'Ho Chi Minh',
boundary_country='VN',
layers='country,region,locality'
)
# Reverse geocoding
r = api.reverse(48.858268, 2.294471)
# Autocomplete
r = api.autocomplete('Ho Chi Minh')
# Expand an address (remove abbreviations, possibly with multiple ambiguities - for example, St may expand to either Street or Saint)
r = api.expand('475 Sansome St San Francisco CA')
# Parse an address
r = api.parse('475 Sansome St San Francisco CA')
# Parse an address, and get the results in a simple dictionary
r = api.parse('475 Sansome St San Francisco CA', format='keys')
This software is licensed under the Apache License, version 2 ("ALv2"), quoted below.
Copyright 2016 Duy Do
Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.