Skip to main content

Powerful Canada zipcode search engine.

Project description

Welcome to cazipcode Documentation

Powerful Canada zipcode search engine. Powerful geo lat lng search, fuzzy province, city name search out of the box. And powerful search API with high performance sorting.


  • 200,000 + postal code covers most of the place.
  • Rich information of postalcode is available:
    "postalcode": "K1G 0A1",
    "province": "ON",
    "city": "Ottawa",
    "area_name": "Ottawa",
    "area_code": 613,
    "latitude": 45.417874,
    "longitude": -75.648284,
    "population": 33994,
    "dwellings": 14817,
    "elevation": 56,
    "timezone": 5,
    "day_light_savings": 1
  • Human friendly API
from cazipcode import fields, SearchEngine

with SearchEngine() as search:
    # built-in geo search
    result = search.near(lat=45.477873, lng=-75.721100, radius=100)

    # by province, fuzzy name search.
    result = search.by_province("on")

    # by city, fuzzy name search.
    result = search.by_city("otawa")

    # easy to sort and limit result
    # Top 5 high population postal ocde in ON
    result = search.by_province("on",
        sort_by=fields.province, ascending=False, returns=10)

    # by population dwellings timezone
    result = search.by_population(population_greater=10000)
    result = search.by_dwellings(dwellings_greater=10000)
    result = search.by_timezone(timezone_greater=5, timezone_less=8)

    # by 3-d space
        lat_greater, lat_less, lng_greater, lng_less,
        elevation_greater, elevation_less,
    ) = None, None, None, None, None, None
    result = search.by_lat_lng_elevation(
        lat_greater, lat_less, lng_greater, lng_less,
        elevation_greater, elevation_less,
  • Powerful query
from cazipcode import fields, SearchEngine

# combination of any criterions
result = search.find(
    lat=None, lng=None, radius=None,
    lat_greater=None, lat_less=None,
    lng_greater=None, lng_less=None,
    elevation_greater=None, elevation_less=None,
    province=None, city=None, area_name=None,
    population_greater=None, population_less=None,
    dwellings_greater=None, dwellings_less=None,
    timezone=None, timezone_greater=None, timezone_less=None,


cazipcode is released on PyPI, so all you need is:

$ pip install cazipcode

To upgrade to latest version:

$ pip install --upgrade cazipcode

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cazipcode, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size cazipcode-0.0.2.tar.gz (2.9 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page