Stadia Maps Python API Client
The Stadia Maps Geospatial APIs provide you with the data you need to build awesome applications.
For more information about the API, please visit https://docs.stadiamaps.com
Requirements.
Python 3.8+
Installation & Usage
You can install via your favorite package manager. For example:
pip
pip install stadiamaps
poetry
poetry add stadiamaps
Tests
Execute pytest to run the tests. These are run automatically via CI.
Getting Started
After following the installation procedure, you'll need a Stadia Maps API key.
You can create an API key for free here (no credit card required).
import os
import stadiamaps
from stadiamaps.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to https://api.stadiamaps.com
# You can also use our EU endpoint to keep traffic within the EU like so:
# configuration = stadiamaps.Configuration(host="https://api-eu.stadiamaps.com")
# See configuration.py for a list of all supported configuration parameters.
configuration = stadiamaps.Configuration()
# Configure API key authorization. This example assumes it is injected via an environment
# variable.
configuration.api_key['ApiKeyAuth'] = os.environ["API_KEY"]
# Enter a context with an instance of the API client
with stadiamaps.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = stadiamaps.GeocodingApi(api_client)
text = "Kursi 3" # str | The place name (address, venue name, etc.) to search for.
try:
# Search and geocode quickly based on partial input.
api_response = api_instance.search_v2(text, lang="en")
print("The response of GeocodingApi->autocomplete:\n")
pprint(api_response)
except ApiException as e:
print("Exception when calling GeocodingApi->autocomplete_v2: %s\n" % e)
Check out our integration test folder for more examples.
Documentation
Official documentation lives at docs.stadiamaps.com, where we have both long-form prose explanations of each endpoint and an interactive API reference.
You can also find auto-generated class references below.
API Endpoints
All URIs are relative to https://api.stadiamaps.com
| Class | Method | HTTP request | Description |
|---|---|---|---|
| GeocodingApi | autocomplete | GET /geocoding/v1/autocomplete | Search and geocode quickly based on partial input. |
| GeocodingApi | place | GET /geocoding/v1/place | Retrieve details of a place using its GID. |
| GeocodingApi | reverse | GET /geocoding/v1/reverse | Find places and addresses near geographic coordinates (reverse geocoding). |
| GeocodingApi | search | GET /geocoding/v1/search | Search for location and other info using a place name or address (forward geocoding). |
| GeocodingApi | search_structured | GET /geocoding/v1/search/structured | Find locations matching components (structured forward geocoding). |
| GeocodingApi | search_bulk | GET /geocoding/v1/search/bulk | Bulk geocoding. |
| GeospatialApi | elevation | POST /elevation/v1 | Get the elevation profile along a polyline or at a point. |
| GeospatialApi | tz_lookup | GET /tz/lookup/v1 | Get the current time zone information for any point on earth. |
| RoutingApi | isochrone | POST /isochrone/v1 | Calculate areas of equal travel time from a location. |
| RoutingApi | map_match | POST /map_match/v1 | Match a recorded route to the road network. |
| RoutingApi | nearest_roads | POST /nearest_roads/v1 | Find the nearest roads to the set of input locations. |
| RoutingApi | optimized_route | POST /optimized_route/v1 | Calculate an optimized route between a known start and end point. |
| RoutingApi | route | POST /route/v1 | Get turn by turn routing instructions between two or more locations. |
| RoutingApi | time_distance_matrix | POST /matrix/v1 | Calculate a time distance matrix for use in an optimizer. |
| RoutingApi | trace_attributes | POST /trace_attributes/v1 | Trace the attributes of roads visited on a route. |
1 maintainer
Release files for stadiamaps 8.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| stadiamaps-8.1.0.tar.gz | 183.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| stadiamaps-8.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 542.2 kB
Release files / stadiamaps-8.1.0.tar.gz
| Download URL | stadiamaps-8.1.0.tar.gz |
|---|---|
| Size | 183.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
81b6515bdd33a96f30e64284b2f548d0597a7cdf58ff993e2479a36450c5b9d0
|
|
BLAKE2b-256 checksum How to use checksums |
8ba212e9df24158e06d2043cf66b8319278335d30999cccaffd8b139fd194daf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 27, 2026.
Transparency logRelease files / stadiamaps-8.1.0-py3-none-any.whl
| Download URL | stadiamaps-8.1.0-py3-none-any.whl |
|---|---|
| Size | 359.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe0c4d219681160a7821323bc412aa02cde18d7de034a45f9f007b43278e21b7
|
|
BLAKE2b-256 checksum How to use checksums |
84e0b9ef3b0feedd0f5a505bb4d340b6cf620e6072edc9001a544edd3c91782b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 27, 2026.
Transparency log
