Skip to Content
API • YONDA-INDEX

API Reference

The Yonda API delivers lightweight, high-performance geospatial data and audio stream metadata to mobile devices and web clients.

Blake Carter|Version v3.0.0|CANONICAL

Endpoints

1. Query POIs by Bounding Box

GET /api/v1/pois?minLat=-28.0&minLng=152.0&maxLat=-27.0&maxLng=153.5&theme=history,spooky

Response Format (200 OK)

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [153.0251, -27.4698]
      },
      "properties": {
        "id": "poi_brisbane_heritage_001",
        "title": "Brisbane Arcade Historical Echoes",
        "theme_tags": ["history", "spooky"],
        "trigger_radius_meters": 350.0,
        "narrative": "Built in 1923, this Edwardian arcade...",
        "audio_config": {
          "engine": "eleven_labs",
          "voice_id": "elder_voice_cloned_02",
          "ambience_track": "1920s_jazz"
        }
      }
    }
  ]
}

2. Submit Community Story

POST /api/v1/stories/submit
Content-Type: application/json
 
{
  "title": "Old Mill History",
  "latitude": -27.465,
  "longitude": 153.021,
  "narrative": "Story details...",
  "theme": "history",
  "turnstile_token": "0x4AAA..."
}