Microproduct Data GuideBeginner

Photon Place Search

OpenStreetMap-based Photon place-search results for adding small-scale geocoding to a map application.

Report a Problem

At a Glance

Difficulty
Beginner — comfortable for a first prototype
Size
Tiny · ≤0.001 GB
Formats
GeoJSON
Access
API
API Key
Not Required
Provider
Komoot Photon
Updates
Occasional
Last Verified
Sep 28, 2026
Source Type
Company Source
  • Python Syntax Checked
  • Runnable Notebook

From Source to Product Signal

Test a Product Idea in Four Steps

Komoot's public Photon demo answers small place searches without a key. Start with one query and two results; the demo may throttle heavy use and has no availability guarantee, while OpenStreetMap attribution still applies.

1

Check the Setup

  • Python 3.10 or newer
  • An internet connection
  • The requests Python package
2

Access the Data

  1. 1.Read the Photon public demo policy and OpenStreetMap data terms.
  2. 2.Search for one place with a two-result limit.
  3. 3.Inspect each candidate's name and coordinates before using it.
Open Official Source
3

Run the Python Example

Install the packages, then run the notebook cell.

python -m pip install requests

import requests

response = requests.get(
    "https://photon.komoot.io/api/",
    params={"q": "Zurich", "limit": 2},
    headers={"User-Agent": "TrilemmaDataCatalog/1.0"}, timeout=20,
)
response.raise_for_status()
for place in response.json()["features"]:
    print(place["properties"].get("name"), place["geometry"]["coordinates"])
4

Search for Map Destinations

Show two geocoding candidates with their source coordinates.

  1. 01Query one place name with a bounded result count.
  2. 02Display candidate labels and coordinates for user selection.
  3. 03Explain that similarly named places require location confirmation.

Dataset Details

Komoot Photon is a company source. Last verified 2026-09-28. Temporal coverage: current Photon search index.

Domains

Data Types

Geography

Formats

Provider

Komoot Photon

Data Terms

Komoot permits reasonable free use of its public demo without uptime guarantees; OpenStreetMap-derived data requires ODbL attribution and share-alike compliance.

Send Feedback