Enhanced Places API

A comprehensive REST API that provides rich place data enhanced with AI-generated descriptions, local relationships, and contextual information. Built on Overture Maps data with additional intelligence layers powered by accuracy transfer processing.

API Capabilities

Comprehensive place data enhanced with local intelligence and AI-powered descriptions for building location-aware applications.

Place Search

Search places with multiple filters and parameters

  • Bounding box and coordinate searches
  • Distance-based radius filtering
  • Category and name filtering
  • GeoJSON place collection responses

Field of View

Find places visible from camera field of view

  • Camera-based place discovery
  • Street view integration
  • Visible place feature detection
  • Multiple imagery source support

Place Details

Detailed place information and associated imagery

  • Place retrieval by Overture ID
  • Associated street-level views
  • Mapillary image integration
  • Rich metadata and properties

Accuracy Transfer

Our Enhanced Places API leverages accuracy transfer to improve foundation map data with real-world positioning corrections. By transferring sub-meter precision from Zephr's positioning network to map coordinates, we deliver the most accurate place data available.

Foundation Map Enhancement

Overture Maps data corrected with field-verified positions

Precision Propagation

Sub-meter accuracy transferred from reference points to nearby places

Dynamic Corrections

Continuous improvement through real-world positioning data

Learn more about accuracy transfer

Accuracy Comparison

Enhanced Positioning

3-5m GPS accuracy
<1m precision positioning

Local Context

Approximate distances
Exact local relationships

Real-World Accuracy

Map-based coordinates
Field-verified positions

API Integration

Simple REST API with powerful location query capabilities and rich response data.

Example Request

curl --request GET \
  --url 'https://api.zephr.xyz/v1/places/search?h3=882681a307fffff&limit=1000&confidence=0.9' \
  --header 'authorization: Bearer <token>' \
  --header 'content-type: application/json' \
  --header 'referrer: https://zephr.xyz/'

Enhanced Response

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "id": "bc566266-7347-45ae-932f-20d0f7c2f0a9",
        "name": "Illegal Pete's",
        "description": null,
        "category": "texmex_restaurant",
        "primary_category": "Texmex Restaurant",
        "alternate_categories": "Mexican Restaurant, Bar",
        "address": null,
        "full_address": "1447 Pearl St",
        "locality": "Boulder",
        "region": "CO",
        "postcode": "80302-5306",
        "overture_id": "08f2681a306c53610357d0b880befcb6",
        "augmentations": {
          "ai_description": {
            "s3_key": "place-descriptions/08f2681a306c53610357d0b880befcb6.md",
            "summary": "Here's a concise summary of Illegal Pete's: Nestled on Boulder's bustling Pearl Street, Illegal Pete's is a beloved local Tex-Mex restaurant that has been serving up mission-style burritos and creative Mexican-inspired cuisine since 1995. With its energetic atmosphere, diverse menu, and strong community roots, this independently-owned spot offers a vibrant dining experience that appeals to students, locals, and visitors alike, making it a must-visit culinary destination in downtown Boulder.",
            "s3_bucket": "zephrture-place-descriptions",
            "overture_id": "08f2681a306c53610357d0b880befcb6",
            "generated_at": "2025-08-25 21:02:15.102846+00:00"
          }
        },
        "last_enriched_at": "2025-08-25T21:02:15.102867",
        "overture_compat": {
          "id": "08f2681a306c53610357d0b880befcb6",
          "categories": {
            "primary": "texmex_restaurant",
            "alternate": [
              "Mexican Restaurant",
              "Bar"
            ]
          },
          "names": {
            "primary": "Illegal Pete's"
          },
          "addresses": [
            {
              "freeform": "1447 Pearl St",
              "locality": "Boulder",
              "region": "CO",
              "postcode": "80302-5306"
            }
          ],
          "confidence": 0.9671629803533918
        }
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -105.2766696,
          40.0186904
        ]
      }
    },
    ...

Start Building with Enhanced Places

Access the most accurate place data available, enhanced with AI descriptions and powered by accuracy transfer technology.