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.