Python Client for Mapzen APIs
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Python Client for Mapzen APIs

A Python client for the Mapzen APIs.

Mapzen Features

  • 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+


from mapzen.api import MapzenAPI

api_key = 'your api_key'
api = MapzenAPI(api_key)

# Search a specific location
# r ='Ho Chi Minh')

# Search within Vietnam
r =
    'Ho Chi Minh',

# Search within Vietnam and place types: country, region or locality (towns, hamlets, cities)
r =
    'Ho Chi Minh',

# 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

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.