GIS.PH Python SDK

Official Python client for api.gis.ph.

Status: 0.2.0 alpha · Docs: docs.gis.ph/sdks/python · Tracking: #1

Install

pip install "gisph @ git+https://github.com/YahaayLabs/gis.ph-sdk-python.git"
# or from a clone:
pip install -e ".[dev]"

Requires Python 3.10+. PyPI (pip install gisph) is planned.

Quick start

Free-tier JSON (no API key)

from gisph import Client

with Client() as client:
    print(client.regions.list(limit=5)["data"])
    print(client.barangays.list(province="Cebu", municipality="Poro", limit=10)["data"])

Auth: reverse geocode + waterways session

from gisph import Client

client = Client(api_key="YOUR_API_KEY")
place = client.geocode.reverse(lat=10.3157, lng=123.8854)
session = client.tiles.create_session("ph_waterways_lines")
print(place["data"]["barangay"], session["data"]["maplibre_url"])
client.close()

Async

from gisph import AsyncClient

async with AsyncClient(api_key="YOUR_API_KEY") as client:
    place = await client.geocode.reverse(lat=10.3157, lng=123.8854)

Resources

Attribute	Methods
regions / provinces / municities	list, get
barangays	list (province required), get, search
geocode	reverse
datasets	list, get, create, update, delete
features	list, get, list_by_dataset, create, update, delete
tiles	list, create_session

Default base URL: https://api.gis.ph/v1.

Errors

GisPhAuthError (401/403), GisPhRateLimitError (429), GisPhHTTPError, base GisPhError.

Development

uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest
python examples/basic.py

License

MIT