{ "openapi": "3.1.0", "info": { "title": "CityRide Public Developer API", "version": "beta", "description": "Future production target; requires separately authorized deployment. Usage monitoring / Beta, not commercial billing. Permanent credentials are backend-only." }, "servers": [ { "url": "https://developer-api.cityride.in", "description": "Future production target — not yet online" }, { "url": "https://dev-api.cityride.in", "description": "Staging" } ], "security": [ { "CityRideKey": [], "CityRideSecret": [] } ], "tags": [ { "name": "Health" }, { "name": "Search" }, { "name": "Routing" }, { "name": "Maps" }, { "name": "Divisions" } ], "components": { "securitySchemes": { "CityRideKey": { "type": "apiKey", "in": "header", "name": "X-CityRide-Key" }, "CityRideSecret": { "type": "apiKey", "in": "header", "name": "X-CityRide-Secret" } }, "schemas": { "PointInput": { "type": "object", "properties": { "lat": { "type": [ "number", "string" ], "minimum": -90, "maximum": 90, "description": "Number or numeric string; gateway applies numeric bounds to either." }, "lon": { "type": [ "number", "string" ], "minimum": -180, "maximum": 180, "description": "Number or numeric string; gateway applies numeric bounds to either." } }, "required": [ "lat", "lon" ], "additionalProperties": true, "description": "Named fields, not positional coordinates. Gateway also accepts numeric strings; examples use numbers." }, "GatewayError": { "type": "object", "properties": { "error": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": { "code": { "type": [ "string", "integer" ] }, "message": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" } }, "required": [ "code", "message" ], "additionalProperties": true } ] } }, "required": [ "error" ], "additionalProperties": true }, "DivisionMetadata": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "local_name": { "type": [ "string", "null" ] }, "type": { "type": "string", "enum": [ "COUNTRY", "STATE", "DISTRICT", "TALUK" ] }, "subtype": { "type": [ "string", "null" ], "enum": [ "STATE", "UNION_TERRITORY", null ] }, "source_local_type": { "type": [ "object", "null" ], "additionalProperties": { "type": "string" } }, "source_original_type": { "type": [ "string", "null" ] }, "source_admin_level": { "type": [ "number", "null" ] }, "parent_id": { "type": [ "string", "null" ] }, "country_code": { "type": "string" }, "state_code": { "type": [ "string", "null" ] }, "breadcrumb": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" } }, "additionalProperties": true } }, "source": { "type": "string", "enum": [ "OVERTURE", "OSM" ] }, "source_external_id": { "type": "string" }, "source_dataset_version": { "type": "string" }, "source_feature_version": { "type": [ "string", "null" ] }, "source_updated_at": { "type": [ "string", "null" ] }, "synced_at": { "type": "string" }, "has_children": { "type": "boolean" }, "has_geometry": { "type": "boolean" }, "bbox": { "type": "array", "items": { "type": "number" }, "minItems": 4, "maxItems": 4, "description": "west,south,east,north (longitude,latitude)." }, "area": { "type": "number" }, "area_unit": { "type": "string" }, "geometry_version": { "type": [ "string", "null" ], "format": "uuid" }, "status": { "type": "string" }, "coverage": { "type": "string" }, "ambiguity_reason": { "type": [ "string", "null" ] }, "attribution": { "type": "object", "properties": { "text": { "type": "string" }, "license": { "type": "string" }, "license_url": { "type": "string" }, "osm_url": { "type": "string" }, "overture_url": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true, "required": [ "id", "name", "local_name", "type", "subtype", "source_local_type", "source_original_type", "source_admin_level", "parent_id", "country_code", "state_code", "breadcrumb", "source", "source_external_id", "source_dataset_version", "source_feature_version", "source_updated_at", "synced_at", "has_children", "has_geometry", "bbox", "area", "area_unit", "geometry_version", "status", "coverage", "ambiguity_reason", "attribution" ] }, "DivisionPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/DivisionMetadata" } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": [ "string", "null" ] }, "catalog_version": { "type": "string" } }, "required": [ "items", "has_more", "next_cursor", "catalog_version" ], "additionalProperties": true }, "BoundaryGeometry": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "Polygon" }, "coordinates": { "type": "array", "items": { "type": "array", "items": { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2 }, "minItems": 4 }, "minItems": 1 } }, "required": [ "type", "coordinates" ], "additionalProperties": true }, { "type": "object", "properties": { "type": { "type": "string", "const": "MultiPolygon" }, "coordinates": { "type": "array", "items": { "type": "array", "items": { "type": "array", "items": { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2 }, "minItems": 4 }, "minItems": 1 }, "minItems": 1 } }, "required": [ "type", "coordinates" ], "additionalProperties": true } ], "description": "Nonempty valid EPSG:4326 geometry. Rings closed. Longitude first; validity enforced at publication." }, "BoundaryFeature": { "type": "object", "properties": { "type": { "type": "string", "const": "Feature" }, "id": { "type": "string", "format": "uuid" }, "bbox": { "type": "array", "items": { "type": "number" }, "minItems": 4, "maxItems": 4 }, "geometry": { "$ref": "#/components/schemas/BoundaryGeometry" }, "properties": { "type": "object", "properties": { "division_id": { "type": "string" }, "name": { "type": "string" }, "normalized_type": { "type": "string" }, "source": { "type": "string" }, "source_external_id": { "type": "string" }, "source_dataset_version": { "type": "string" }, "source_feature_version": { "type": "string" }, "source_updated_at": { "type": "string" }, "geometry_version": { "type": "string" }, "synced_at": { "type": "string" }, "attribution": { "type": "object", "properties": { "text": { "type": "string" }, "license": { "type": "string" }, "license_url": { "type": "string" }, "osm_url": { "type": "string" }, "overture_url": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true, "required": [ "division_id", "name", "normalized_type", "source", "source_external_id", "source_dataset_version", "source_feature_version", "source_updated_at", "geometry_version", "synced_at", "attribution" ] } }, "required": [ "type", "id", "bbox", "geometry", "properties" ], "additionalProperties": true }, "PlaceResult": { "type": "object", "properties": { "place_id": { "type": [ "number", "string" ] }, "licence": { "type": "string" }, "osm_type": { "type": "string" }, "osm_id": { "type": "number" }, "lat": { "type": [ "number", "string" ] }, "lon": { "type": [ "number", "string" ] }, "category": { "type": "string" }, "type": { "type": "string" }, "place_rank": { "type": "number" }, "importance": { "type": "number" }, "addresstype": { "type": "string" }, "name": { "type": "string" }, "display_name": { "type": "string" }, "boundingbox": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true, "description": "Observed geocoder fields, optional/provider-dependent. Retain licence. Nominatim place_id is not a stable CityRide division ID." } } }, "paths": { "/api/v1/search": { "get": { "operationId": "search", "tags": [ "Search" ], "summary": "Forward geocoder place/address search. Empty successful array means no matches.", "description": "Required permission: search. Provider fields may vary.", "x-required-permissions": [ "search" ], "parameters": [ { "name": "q", "in": "query", "required": false, "description": "Named place/address. Search also forwards structured Nominatim parameters; no gateway requirement for q in that alternate mode.", "schema": { "type": "string", "minLength": 1, "maxLength": 500 } }, { "name": "limit", "in": "query", "required": false, "description": "Result limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } }, { "name": "format", "in": "query", "required": false, "description": "Forwarded format. json/jsonv2 default examples; geojson/geocodejson change response shape.", "schema": { "type": "string", "enum": [ "json", "jsonv2", "geojson", "geocodejson" ] } }, { "name": "accept-language", "in": "query", "required": false, "description": "Language preferences, e.g. en or kn,en;q=0.8. Validated language-tag/quality syntax, max100 characters.", "schema": { "type": "string", "maxLength": 100 } }, { "name": "viewbox", "in": "query", "required": false, "description": "lon1,lat1,lon2,lat2; each pair in degree bounds.", "schema": { "type": "string" } }, { "name": "polygon_threshold", "in": "query", "required": false, "description": "Simplification option.", "schema": { "type": "number", "minimum": 0, "maximum": 1 } }, { "name": "addressdetails", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "extratags", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "namedetails", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "bounded", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "dedupe", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_geojson", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_text", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_kml", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_svg", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "street", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "city", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "county", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "state", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "country", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "postalcode", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "countrycodes", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "exclude_place_ids", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "email", "in": "query", "required": false, "description": "Optional structured Nominatim address filter; forwarded, max500characters.", "schema": { "type": "string", "maxLength": 500 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "oneOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/PlaceResult" } }, { "type": "object", "properties": {}, "additionalProperties": true } ], "description": "Array for default json/jsonv2 search; GeoJSON/geocodejson object if requested. Upstream-specific fields preserved." }, "example": [ { "place_id": 9048481, "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright", "osm_type": "relation", "osm_id": 2020624, "lat": "13.4192512", "lon": "76.8810004", "category": "boundary", "type": "administrative", "place_rank": 10, "importance": 0.2666766666666667, "addresstype": "state_district", "name": "Tumakuru", "display_name": "Tumakuru, Karnataka, India", "boundingbox": [ "12.7455612", "14.3423342", "76.3462278", "77.5170421" ] } ] } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/autocomplete": { "get": { "operationId": "autocomplete", "tags": [ "Search" ], "summary": "Ranked Overture/Nominatim suggestions; source/fallback behavior depends on query.", "description": "Required permission: autocomplete. Provider fields may vary.", "x-required-permissions": [ "autocomplete" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "", "schema": { "type": "string", "minLength": 2, "maxLength": 500 } }, { "name": "limit", "in": "query", "required": false, "description": "Result limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10 } }, { "name": "lat", "in": "query", "required": false, "description": "Latitude in degrees; paired with lon.", "schema": { "type": "number", "minimum": -90, "maximum": 90 } }, { "name": "lon", "in": "query", "required": false, "description": "Longitude in degrees; paired with lat.", "schema": { "type": "number", "minimum": -180, "maximum": 180 } }, { "name": "location", "in": "query", "required": false, "description": "Alternative lat,lon string. Explicit lat/lon pair takes precedence.", "schema": { "type": "string" } }, { "name": "radius", "in": "query", "required": false, "description": "Meters. Accepted1..200000; effective clamp1000..200000, default10000. Explicit radius with coordinates is a geographic bound.", "schema": { "type": "number", "minimum": 1, "maximum": 200000, "default": 10000 } }, { "name": "accept-language", "in": "query", "required": false, "description": "Language preferences, e.g. en or kn,en;q=0.8. Validated language-tag/quality syntax, max100 characters.", "schema": { "type": "string", "maxLength": 100 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PlaceResult" } }, "example": [ { "place_id": 8672490, "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright", "osm_type": "relation", "osm_id": 7902476, "lat": "12.9767936", "lon": "77.5900820", "category": "boundary", "type": "administrative", "place_rank": 14, "importance": 0.2133433333333333, "addresstype": "city", "name": "Bengaluru", "display_name": "Bengaluru, Bangalore North, Bengaluru Urban, Karnataka, India", "address": { "city": "Bengaluru", "county": "Bangalore North", "state_district": "Bengaluru Urban", "state": "Karnataka", "ISO3166-2-lvl4": "IN-KA", "country": "India", "country_code": "in" }, "boundingbox": [ "12.8334905", "13.1426196", "77.4598797", "77.7840639" ] }, { "place_id": 8727222, "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright", "osm_type": "relation", "osm_id": 2020589, "lat": "12.9461554", "lon": "77.5503844", "category": "boundary", "type": "administrative", "place_rank": 10, "importance": 0.2666766666666667, "addresstype": "state_district", "name": "Bengaluru Urban", "display_name": "Bengaluru Urban, Karnataka, India", "address": { "state_district": "Bengaluru Urban", "state": "Karnataka", "ISO3166-2-lvl4": "IN-KA", "country": "India", "country_code": "in" }, "boundingbox": [ "12.6580091", "13.2346762", "77.3255304", "77.8369637" ] } ] } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/reverse": { "get": { "operationId": "reverse", "tags": [ "Search" ], "summary": "Resolve address/place at coordinates.", "description": "Required permission: reverse. Provider fields may vary.", "x-required-permissions": [ "reverse" ], "parameters": [ { "name": "lat", "in": "query", "required": true, "description": "Latitude in degrees; paired with lon.", "schema": { "type": "number", "minimum": -90, "maximum": 90 } }, { "name": "lon", "in": "query", "required": true, "description": "Longitude in degrees; paired with lat.", "schema": { "type": "number", "minimum": -180, "maximum": 180 } }, { "name": "zoom", "in": "query", "required": false, "description": "Geocoder detail zoom.", "schema": { "type": "integer", "minimum": 0, "maximum": 18 } }, { "name": "format", "in": "query", "required": false, "description": "Forwarded format. json/jsonv2 default examples; geojson/geocodejson change response shape.", "schema": { "type": "string", "enum": [ "json", "jsonv2", "geojson", "geocodejson" ] } }, { "name": "accept-language", "in": "query", "required": false, "description": "Language preferences, e.g. en or kn,en;q=0.8. Validated language-tag/quality syntax, max100 characters.", "schema": { "type": "string", "maxLength": 100 } }, { "name": "viewbox", "in": "query", "required": false, "description": "lon1,lat1,lon2,lat2; each pair in degree bounds.", "schema": { "type": "string" } }, { "name": "polygon_threshold", "in": "query", "required": false, "description": "Simplification option.", "schema": { "type": "number", "minimum": 0, "maximum": 1 } }, { "name": "addressdetails", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "extratags", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "namedetails", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "bounded", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "dedupe", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_geojson", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_text", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_kml", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_svg", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "place_id": { "type": "number" }, "licence": { "type": "string" }, "osm_type": { "type": "string" }, "osm_id": { "type": "number" }, "lat": { "type": "string" }, "lon": { "type": "string" }, "category": { "type": "string" }, "type": { "type": "string" }, "place_rank": { "type": "number" }, "importance": { "type": "number" }, "addresstype": { "type": "string" }, "name": { "type": "string" }, "display_name": { "type": "string" }, "address": { "type": "object", "properties": { "amenity": { "type": "string" }, "road": { "type": "string" }, "neighbourhood": { "type": "string" }, "quarter": { "type": "string" }, "suburb": { "type": "string" }, "city_district": { "type": "string" }, "city": { "type": "string" }, "county": { "type": "string" }, "state_district": { "type": "string" }, "state": { "type": "string" }, "ISO3166-2-lvl4": { "type": "string" }, "postcode": { "type": "string" }, "country": { "type": "string" }, "country_code": { "type": "string" } }, "additionalProperties": true }, "boundingbox": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "example": { "place_id": 8730882, "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright", "osm_type": "way", "osm_id": 38773287, "lat": "12.9703357", "lon": "77.5950840", "category": "amenity", "type": "school", "place_rank": 30, "importance": 0.00000999999999995449, "addresstype": "amenity", "name": "St. Joseph's Indian High School", "display_name": "St. Joseph's Indian High School, Vittal Mallya Road, D'Souza Layout, Shanthala Nagar, Ashokanagar, Bengaluru Central City Corporation, Bengaluru, Bangalore North, Bengaluru Urban, Karnataka, 560001, India", "address": { "amenity": "St. Joseph's Indian High School", "road": "Vittal Mallya Road", "neighbourhood": "D'Souza Layout", "quarter": "Shanthala Nagar", "suburb": "Ashokanagar", "city_district": "Bengaluru Central City Corporation", "city": "Bengaluru", "county": "Bangalore North", "state_district": "Bengaluru Urban", "state": "Karnataka", "ISO3166-2-lvl4": "IN-KA", "postcode": "560001", "country": "India", "country_code": "in" }, "boundingbox": [ "12.9685229", "12.9717834", "77.5942778", "77.5959810" ] } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/nearby": { "get": { "operationId": "nearby", "tags": [ "Search" ], "summary": "Bounded geocoder category/text search around a coordinate.", "description": "Required permission: nearby. Provider fields may vary.", "x-required-permissions": [ "nearby" ], "parameters": [ { "name": "lat", "in": "query", "required": true, "description": "Latitude in degrees; paired with lon.", "schema": { "type": "number", "minimum": -90, "maximum": 90 } }, { "name": "lon", "in": "query", "required": true, "description": "Longitude in degrees; paired with lat.", "schema": { "type": "number", "minimum": -180, "maximum": 180 } }, { "name": "q", "in": "query", "required": false, "description": "q or category required; q takes precedence.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "category", "in": "query", "required": false, "description": "Fallback search term if q absent.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "radius", "in": "query", "required": false, "description": "Meters; accepted1..50000, effective clamp100..50000, default5000. Uses approximate bounding box, not strict circular-distance filtering.", "schema": { "type": "number", "minimum": 1, "maximum": 50000, "default": 5000 } }, { "name": "limit", "in": "query", "required": false, "description": "Result limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PlaceResult" } }, "example": [ { "place_id": 8724233, "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright", "osm_type": "node", "osm_id": 4446312027, "lat": "12.9914123", "lon": "77.6117329", "class": "amenity", "type": "hospital", "place_rank": 30, "importance": 0.00000999999999995449, "addresstype": "amenity", "name": "Hospital", "display_name": "Hospital, Saint John's Church Road, Bharathi Nagar, Bengaluru Central City Corporation, Bengaluru, Bangalore North, Bengaluru Urban, Karnataka, 560001, India", "boundingbox": [ "12.9913623", "12.9914623", "77.6116829", "77.6117829" ] } ] } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/place-details": { "get": { "operationId": "place_details", "tags": [ "Search" ], "summary": "Nominatim detail by place_id; only place_id is forwarded, format forced json.", "description": "Required permission: place-details. Provider fields may vary.", "x-required-permissions": [ "place-details" ], "parameters": [ { "name": "place_id", "in": "query", "required": true, "description": "Numeric Nominatim place_id from geocoder response; not an Overture or division ID.", "schema": { "type": "string", "pattern": "^[0-9]+$", "maxLength": 64 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "place_id": { "type": "number" }, "parent_place_id": { "type": "number" }, "osm_type": { "type": "string" }, "osm_id": { "type": "number" }, "category": { "type": "string" }, "type": { "type": "string" }, "admin_level": { "type": "number" }, "localname": { "type": "string" }, "names": { "type": "object", "properties": { "name": { "type": "string" }, "name:kn": { "type": "string" }, "name:ko": { "type": "string" }, "official_name": { "type": "string" } }, "additionalProperties": true }, "addresstags": { "type": "object", "properties": {}, "additionalProperties": true }, "country_code": { "type": "string" }, "indexed_date": { "type": "string" }, "importance": { "type": "number" }, "calculated_importance": { "type": "number" }, "extratags": { "type": "object", "properties": { "wikidata": { "type": "string" }, "wikipedia": { "type": "string" }, "admin_level": { "type": "string" } }, "additionalProperties": true }, "rank_address": { "type": "number" }, "rank_search": { "type": "number" }, "isarea": { "type": "boolean" }, "centroid": { "type": "object", "properties": { "type": { "type": "string" }, "coordinates": { "type": "array", "items": { "type": "number" } } }, "additionalProperties": true }, "geometry": { "type": "object", "properties": { "type": { "type": "string" }, "coordinates": { "type": "array", "items": { "type": "number" } } }, "additionalProperties": true } }, "additionalProperties": true }, "example": { "place_id": 9048481, "parent_place_id": 8262692, "osm_type": "R", "osm_id": 2020624, "category": "boundary", "type": "administrative", "admin_level": 5, "localname": "Tumakuru", "names": { "name": "Tumakuru", "name:kn": "ತುಮಕೂರು ಜಿಲ್ಲೆ", "name:ko": "투마쿠루", "official_name": "Tumakuru District" }, "addresstags": {}, "country_code": "in", "indexed_date": "2026-09-06T03:28:38.312685+00:00", "importance": 0.2666766666666667, "calculated_importance": 0.2666766666666667, "extratags": { "wikidata": "Q1301635", "wikipedia": "en:Tumakuru district", "admin_level": "5" }, "rank_address": 10, "rank_search": 10, "isarea": true, "centroid": { "type": "Point", "coordinates": [ 76.8810004, 13.4192512 ] }, "geometry": { "type": "Point", "coordinates": [ 76.8810004, 13.4192512 ] } } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/place-details-advanced": { "get": { "operationId": "place_details_advanced", "tags": [ "Search" ], "summary": "Nominatim detail response; advanced form forwards query options.", "description": "Required permission: place-details-advanced. Provider fields may vary.", "x-required-permissions": [ "place-details-advanced" ], "parameters": [ { "name": "place_id", "in": "query", "required": false, "description": "Numeric Nominatim place_id from geocoder response; not an Overture or division ID.", "schema": { "type": "string", "pattern": "^[0-9]+$", "maxLength": 64 } }, { "name": "osm_type", "in": "query", "required": false, "description": "Alternative OSM identity with osm_id; forwarded.", "schema": { "type": "string", "enum": [ "N", "W", "R", "n", "w", "r" ] } }, { "name": "osm_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, { "name": "format", "in": "query", "required": false, "description": "Forwarded format. json/jsonv2 default examples; geojson/geocodejson change response shape.", "schema": { "type": "string", "enum": [ "json", "jsonv2", "geojson", "geocodejson" ] } }, { "name": "accept-language", "in": "query", "required": false, "description": "Language preferences, e.g. en or kn,en;q=0.8. Validated language-tag/quality syntax, max100 characters.", "schema": { "type": "string", "maxLength": 100 } }, { "name": "viewbox", "in": "query", "required": false, "description": "lon1,lat1,lon2,lat2; each pair in degree bounds.", "schema": { "type": "string" } }, { "name": "polygon_threshold", "in": "query", "required": false, "description": "Simplification option.", "schema": { "type": "number", "minimum": 0, "maximum": 1 } }, { "name": "addressdetails", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "extratags", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "namedetails", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "bounded", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "dedupe", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_geojson", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_text", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_kml", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } }, { "name": "polygon_svg", "in": "query", "required": false, "description": "Forwarded geocoder option; upstream support depends on endpoint.", "schema": { "type": "integer", "minimum": 0, "maximum": 1 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "place_id": { "type": "number" }, "parent_place_id": { "type": "number" }, "osm_type": { "type": "string" }, "osm_id": { "type": "number" }, "category": { "type": "string" }, "type": { "type": "string" }, "admin_level": { "type": "number" }, "localname": { "type": "string" }, "names": { "type": "object", "properties": { "name": { "type": "string" }, "name:kn": { "type": "string" }, "name:ko": { "type": "string" }, "official_name": { "type": "string" } }, "additionalProperties": true }, "addresstags": { "type": "object", "properties": {}, "additionalProperties": true }, "country_code": { "type": "string" }, "indexed_date": { "type": "string" }, "importance": { "type": "number" }, "calculated_importance": { "type": "number" }, "extratags": { "type": "object", "properties": { "wikidata": { "type": "string" }, "wikipedia": { "type": "string" }, "admin_level": { "type": "string" } }, "additionalProperties": true }, "rank_address": { "type": "number" }, "rank_search": { "type": "number" }, "isarea": { "type": "boolean" }, "centroid": { "type": "object", "properties": { "type": { "type": "string" }, "coordinates": { "type": "array", "items": { "type": "number" } } }, "additionalProperties": true }, "geometry": { "type": "object", "properties": { "type": { "type": "string" }, "coordinates": { "type": "array", "items": { "type": "number" } } }, "additionalProperties": true }, "address": { "type": "array", "items": { "type": "object", "properties": { "localname": { "type": "string" }, "place_id": { "type": "number" }, "osm_id": { "type": "number" }, "osm_type": { "type": "string" }, "class": { "type": "string" }, "type": { "type": "string" }, "admin_level": { "type": "number" }, "rank_address": { "type": "number" }, "distance": { "type": "number" }, "isaddress": { "type": "boolean" } }, "additionalProperties": true } } }, "additionalProperties": true }, "example": { "place_id": 9048481, "parent_place_id": 8262692, "osm_type": "R", "osm_id": 2020624, "category": "boundary", "type": "administrative", "admin_level": 5, "localname": "Tumakuru", "names": { "name": "Tumakuru", "name:kn": "ತುಮಕೂರು ಜಿಲ್ಲೆ", "name:ko": "투마쿠루", "official_name": "Tumakuru District" }, "addresstags": {}, "country_code": "in", "indexed_date": "2026-09-06T03:28:38.312685+00:00", "importance": 0.2666766666666667, "calculated_importance": 0.2666766666666667, "extratags": { "wikidata": "Q1301635", "wikipedia": "en:Tumakuru district", "admin_level": "5" }, "rank_address": 10, "rank_search": 10, "isarea": true, "centroid": { "type": "Point", "coordinates": [ 76.8810004, 13.4192512 ] }, "geometry": { "type": "Point", "coordinates": [ 76.8810004, 13.4192512 ] }, "address": [ { "localname": "Tumakuru", "place_id": 9048481, "osm_id": 2020624, "osm_type": "R", "class": "boundary", "type": "administrative", "admin_level": 5, "rank_address": 10, "distance": 0, "isaddress": true }, { "localname": "Karnataka", "place_id": 8262692, "osm_id": 2019939, "osm_type": "R", "class": "boundary", "type": "administrative", "admin_level": 4, "rank_address": 8, "distance": 0.00001884998286326169, "isaddress": true }, { "localname": "in", "class": "place", "type": "country_code", "rank_address": 4, "distance": 0, "isaddress": false }, { "localname": "India", "class": "place", "type": "country", "rank_address": 4, "distance": 0, "isaddress": true } ] } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/address-validation": { "post": { "operationId": "address_validation", "tags": [ "Search" ], "summary": "Geocode one address and normalize match/no-match. This is not postal deliverability certification.", "description": "Required permission: address-validation. Provider fields may vary.", "x-required-permissions": [ "address-validation" ], "parameters": [], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "valid": { "type": "boolean" }, "formatted_address": { "type": [ "string", "null" ] }, "location": { "type": [ "object", "null" ], "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "additionalProperties": true }, "address": { "type": [ "object", "null" ], "properties": { "state_district": { "type": "string" }, "state": { "type": "string" }, "ISO3166-2-lvl4": { "type": "string" }, "country": { "type": "string" }, "country_code": { "type": "string" } }, "additionalProperties": true }, "place_id": { "type": [ "number", "null" ] }, "osm_type": { "type": [ "string", "null" ] }, "osm_id": { "type": [ "number", "null" ] }, "category": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "boundingbox": { "type": [ "array", "null" ], "items": { "type": "string" } } }, "additionalProperties": true, "required": [ "valid", "formatted_address", "location", "address", "place_id", "osm_type", "osm_id", "category", "type", "boundingbox" ] }, "example": { "valid": true, "formatted_address": "Tumakuru, Karnataka, India", "location": { "lat": 13.4192512, "lon": 76.8810004 }, "address": { "state_district": "Tumakuru", "state": "Karnataka", "ISO3166-2-lvl4": "IN-KA", "country": "India", "country_code": "in" }, "place_id": 9048481, "osm_type": "relation", "osm_id": 2020624, "category": "boundary", "type": "administrative", "boundingbox": [ "12.7455612", "14.3423342", "76.3462278", "77.5170421" ] } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string", "minLength": 1, "maxLength": 500 }, "q": { "type": "string", "minLength": 1, "maxLength": 500 }, "lat": { "type": "number" }, "lon": { "type": "number" } }, "additionalProperties": true, "anyOf": [ { "required": [ "address" ] }, { "required": [ "q" ] } ], "description": "address preferred, q alias; validation uses address ?? q. Supply one nonblank value. Optional body lat/lon are forwarded when numeric, without geographic range validation here; applications must enforce WGS84 bounds." }, "example": { "address": "Tumakuru, Karnataka, India" } } } } } }, "/api/v1/route": { "post": { "operationId": "route", "tags": [ "Routing" ], "summary": "Compute route via Valhalla route.", "description": "Required permission: route. Provider fields may vary.", "x-required-permissions": [ "route" ], "parameters": [], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "trip": { "type": "object", "properties": { "locations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "lat": { "type": "number" }, "lon": { "type": "number" }, "original_index": { "type": "number" } }, "additionalProperties": true } }, "legs": { "type": "array", "items": { "type": "object", "properties": { "maneuvers": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "number" }, "instruction": { "type": "string" }, "verbal_succinct_transition_instruction": { "type": "string" }, "verbal_pre_transition_instruction": { "type": "string" }, "verbal_post_transition_instruction": { "type": "string" }, "bearing_after": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" }, "begin_shape_index": { "type": "number" }, "end_shape_index": { "type": "number" }, "verbal_multi_cue": { "type": "boolean" }, "travel_mode": { "type": "string" }, "travel_type": { "type": "string" } }, "additionalProperties": true } }, "summary": { "type": "object", "properties": { "has_time_restrictions": { "type": "boolean" }, "has_toll": { "type": "boolean" }, "has_highway": { "type": "boolean" }, "has_ferry": { "type": "boolean" }, "min_lat": { "type": "number" }, "min_lon": { "type": "number" }, "max_lat": { "type": "number" }, "max_lon": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" } }, "additionalProperties": true }, "shape": { "type": "string" } }, "additionalProperties": true } }, "summary": { "type": "object", "properties": { "has_time_restrictions": { "type": "boolean" }, "has_toll": { "type": "boolean" }, "has_highway": { "type": "boolean" }, "has_ferry": { "type": "boolean" }, "min_lat": { "type": "number" }, "min_lon": { "type": "number" }, "max_lat": { "type": "number" }, "max_lon": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" } }, "additionalProperties": true }, "status_message": { "type": "string" }, "status": { "type": "number" }, "units": { "type": "string" }, "language": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true }, "example": { "trip": { "locations": [ { "type": "break", "lat": 12.9716, "lon": 77.5946, "original_index": 0 }, { "type": "break", "lat": 12.975, "lon": 77.6, "side_of_street": "right", "original_index": 1 } ], "legs": [ { "maneuvers": [ { "type": 1, "instruction": "Drive east.", "verbal_succinct_transition_instruction": "Drive east. Then Turn left.", "verbal_pre_transition_instruction": "Drive east. Then Turn left.", "verbal_post_transition_instruction": "Continue for 30 meters.", "bearing_after": 112, "time": 11.52, "length": 0.032, "cost": 14.112, "begin_shape_index": 0, "end_shape_index": 2, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left.", "verbal_transition_alert_instruction": "Turn left.", "verbal_succinct_transition_instruction": "Turn left. Then Turn left onto Vittal Mallya Road.", "verbal_pre_transition_instruction": "Turn left. Then Turn left onto Vittal Mallya Road.", "verbal_post_transition_instruction": "Continue for 20 meters.", "bearing_before": 109, "bearing_after": 16, "time": 39.787, "length": 0.019, "cost": 499.32, "begin_shape_index": 2, "end_shape_index": 6, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left onto Vittal Mallya Road.", "verbal_transition_alert_instruction": "Turn left onto Vittal Mallya Road.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left onto Vittal Mallya Road.", "verbal_post_transition_instruction": "Continue for 90 meters.", "street_names": [ "Vittal Mallya Road" ], "bearing_before": 24, "bearing_after": 290, "time": 17.121, "length": 0.093, "cost": 43.831, "begin_shape_index": 6, "end_shape_index": 11, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left onto Kasturba Road.", "verbal_transition_alert_instruction": "Turn left onto Kasturba Road.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left onto Kasturba Road.", "verbal_post_transition_instruction": "Continue for 900 meters.", "street_names": [ "Kasturba Road" ], "bearing_before": 292, "bearing_after": 175, "time": 117.884, "length": 0.858, "cost": 188.3, "begin_shape_index": 11, "end_shape_index": 60, "travel_mode": "drive", "travel_type": "car" }, { "type": 16, "instruction": "Bear left onto Rajaram Mohan Roy Road.", "verbal_transition_alert_instruction": "Bear left onto Rajaram Mohan Roy Road.", "verbal_succinct_transition_instruction": "Bear left.", "verbal_pre_transition_instruction": "Bear left onto Rajaram Mohan Roy Road.", "verbal_post_transition_instruction": "Continue for 200 meters.", "street_names": [ "Rajaram Mohan Roy Road" ], "bearing_before": 114, "bearing_after": 80, "time": 30.924, "length": 0.231, "cost": 49.73, "begin_shape_index": 60, "end_shape_index": 69, "travel_mode": "drive", "travel_type": "car" }, { "type": 16, "instruction": "Bear left onto Residency Road/Field Marshal Cariappa Road.", "verbal_transition_alert_instruction": "Bear left onto Residency Road.", "verbal_succinct_transition_instruction": "Bear left.", "verbal_pre_transition_instruction": "Bear left onto Residency Road, Field Marshal Cariappa Road.", "verbal_post_transition_instruction": "Continue for 900 meters.", "street_names": [ "Residency Road", "Field Marshal Cariappa Road" ], "bearing_before": 67, "bearing_after": 40, "time": 122.334, "length": 0.914, "cost": 169.161, "begin_shape_index": 69, "end_shape_index": 107, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left onto Museum Road.", "verbal_transition_alert_instruction": "Turn left onto Museum Road.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left onto Museum Road.", "verbal_post_transition_instruction": "Continue for 500 meters.", "street_names": [ "Museum Road" ], "bearing_before": 66, "bearing_after": 338, "time": 70.734, "length": 0.476, "cost": 128.341, "begin_shape_index": 107, "end_shape_index": 133, "travel_mode": "drive", "travel_type": "car" }, { "type": 9, "instruction": "Bear right onto Saint Mark's Road.", "verbal_transition_alert_instruction": "Bear right onto Saint Mark's Road.", "verbal_succinct_transition_instruction": "Bear right.", "verbal_pre_transition_instruction": "Bear right onto Saint Mark's Road.", "verbal_post_transition_instruction": "Continue for 200 meters.", "street_names": [ "Saint Mark's Road" ], "bearing_before": 276, "bearing_after": 298, "time": 24.257, "length": 0.164, "cost": 47.054, "begin_shape_index": 133, "end_shape_index": 147, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left.", "verbal_transition_alert_instruction": "Turn left.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left.", "verbal_post_transition_instruction": "Continue for 90 meters.", "bearing_before": 6, "bearing_after": 287, "time": 62.145, "length": 0.086, "cost": 1201.426, "begin_shape_index": 147, "end_shape_index": 152, "travel_mode": "drive", "travel_type": "car" }, { "type": 10, "instruction": "Turn right.", "verbal_transition_alert_instruction": "Turn right.", "verbal_succinct_transition_instruction": "Turn right. Then Turn left.", "verbal_pre_transition_instruction": "Turn right. Then Turn left.", "verbal_post_transition_instruction": "Continue for 10 meters.", "bearing_before": 287, "bearing_after": 10, "time": 8.445, "length": 0.011, "cost": 39.851, "begin_shape_index": 152, "end_shape_index": 154, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left.", "verbal_transition_alert_instruction": "Turn left.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left.", "verbal_post_transition_instruction": "Continue for 50 meters.", "bearing_before": 10, "bearing_after": 278, "time": 21.503, "length": 0.053, "cost": 33.873, "begin_shape_index": 154, "end_shape_index": 156, "travel_mode": "drive", "travel_type": "car" }, { "type": 9, "instruction": "Bear right.", "verbal_transition_alert_instruction": "Bear right.", "verbal_succinct_transition_instruction": "Bear right.", "verbal_pre_transition_instruction": "Bear right.", "verbal_post_transition_instruction": "Continue for 40 meters.", "bearing_before": 271, "bearing_after": 315, "time": 14.734, "length": 0.039, "cost": 25.35, "begin_shape_index": 156, "end_shape_index": 158, "travel_mode": "drive", "travel_type": "car" }, { "type": 5, "instruction": "Your destination is on the right.", "verbal_transition_alert_instruction": "Your destination will be on the right.", "verbal_pre_transition_instruction": "Your destination is on the right.", "bearing_before": 288, "time": 0, "length": 0, "cost": 0, "begin_shape_index": 158, "end_shape_index": 158, "travel_mode": "drive", "travel_type": "car" } ], "summary": { "has_time_restrictions": false, "has_toll": false, "has_highway": false, "has_ferry": false, "min_lat": 12.964998, "min_lon": 77.593994, "max_lat": 12.974866, "max_lon": 77.604807, "time": 541.393, "length": 2.977, "cost": 2440.352 }, "shape": "ogvvWsd__sCvA_FjBgIuAe@eBQm@G_Bk@yFtTm@pBy@lDUr@}EnPlB`FL^x@zApB~Bh@ZjES`Jy@PCdTuClNkBt@IdH{@jC]|ASvIeAfJiAx~@iMvSuClNyAv@KhJaA|u@}JdI_AvASfFu@fASdHq@z@KpCWrGo@v@MlASrHuAbF}@`Eu@bD{@dB_@xAe@lBi@`DqAn@Y|LeH~VmO|IyFnFaEtCkDjA_CfCsF`BcGgAkLg@yA_AiCkAiDg@y@qIyOkb@_k@cKsOUqDYUcBuBiMuNkAuAk@m@_@c@o@s@oAyAsB_CoAwA_WmYyPmS_NsPkJaMqK{OWc@_@q@aCcEwAqEcWkf@y@{AeIyNqL}Q{F_JoD{EoD{EkP{SgAyAy@kA_TuZqAmBEEo^il@cKoV_EsKcJ_VSi@oBaGeDbAgd@fNo@ToErAoBf@kAZeDbAQFwSrHgFbEiB~BaDxGuBnEyClG}AxC}B`FkDlHu@pB_@dBE^q@vM_AxWs@h]KxGk@~VM`Ce@tB_BjCu@h@cB|@aBb@gAJ{@BeAD}E{@yg@aDyBMqDUiBMyEWWlAWnAKf@AH_Kxg@mCW{@MuBrYNjBwBTqD|P" } ], "summary": { "has_time_restrictions": false, "has_toll": false, "has_highway": false, "has_ferry": false, "min_lat": 12.964998, "min_lon": 77.593994, "max_lat": 12.974866, "max_lon": 77.604807, "time": 541.393, "length": 2.977, "cost": 2440.352 }, "status_message": "Found route between points", "status": 0, "units": "kilometers", "language": "en-US" } } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "locations": { "type": "array", "items": { "$ref": "#/components/schemas/PointInput" }, "minItems": 2, "maxItems": 100 }, "costing": { "type": "string", "enum": [ "auto", "bicycle", "pedestrian", "bus", "truck", "motorcycle", "motor_scooter", "taxi", "multimodal", "transit" ] }, "alternates": { "type": "integer", "minimum": 0, "maximum": 2 }, "units": { "type": "string", "description": "Forwarded Valhalla option; examples/default response use kilometers. Read response units." }, "shape_format": { "type": "string", "description": "Forwarded option; default response encoded polyline precision6. Provider support determines other formats." } }, "required": [ "locations", "costing" ], "additionalProperties": true, "not": { "required": [ "encoded_polyline" ] }, "description": "Gateway bounds: depth12,30000nodes,100objectfields,strings4096,arrays2000; additional Valhalla options forwarded. Nested radius/search_radius/gps_accuracy0..1000; best_paths/top_k1..3. Matrix sources×targets≤2500." }, "example": { "locations": [ { "lat": 12.9716, "lon": 77.5946 }, { "lat": 12.975, "lon": 77.6 } ], "costing": "auto" } } } } } }, "/api/v1/matrix": { "post": { "operationId": "matrix", "tags": [ "Routing" ], "summary": "Compute sources_to_targets travel time/distance matrix.", "description": "Required permission: matrix. Provider fields may vary.", "x-required-permissions": [ "matrix" ], "parameters": [], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "sources_to_targets": { "type": "array", "items": { "type": "array", "items": { "type": "object", "properties": { "from_index": { "type": "number" }, "to_index": { "type": "number" }, "time": { "type": "number" }, "distance": { "type": "number" }, "cost": { "type": "number" } }, "additionalProperties": true } } }, "sources": { "type": "array", "items": { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "additionalProperties": true } }, "targets": { "type": "array", "items": { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "additionalProperties": true } }, "units": { "type": "string" }, "algorithm": { "type": "string" } }, "additionalProperties": true }, "example": { "sources_to_targets": [ [ { "from_index": 0, "to_index": 0, "time": 541, "distance": 2.977, "cost": 2440.352 } ] ], "sources": [ { "lat": 12.971656, "lon": 77.594713 } ], "targets": [ { "lat": 12.974866, "lon": 77.599956 } ], "units": "kilometers", "algorithm": "timedistancematrix" } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sources": { "type": "array", "items": { "$ref": "#/components/schemas/PointInput" }, "minItems": 1, "maxItems": 50 }, "costing": { "type": "string", "enum": [ "auto", "bicycle", "pedestrian", "bus", "truck", "motorcycle", "motor_scooter", "taxi", "multimodal", "transit" ] }, "alternates": { "type": "integer", "minimum": 0, "maximum": 2 }, "units": { "type": "string", "description": "Forwarded Valhalla option; examples/default response use kilometers. Read response units." }, "shape_format": { "type": "string", "description": "Forwarded option; default response encoded polyline precision6. Provider support determines other formats." }, "targets": { "type": "array", "items": { "$ref": "#/components/schemas/PointInput" }, "minItems": 1, "maxItems": 50 } }, "required": [ "sources", "costing", "targets" ], "additionalProperties": true, "not": { "required": [ "encoded_polyline" ] }, "description": "Gateway bounds: depth12,30000nodes,100objectfields,strings4096,arrays2000; additional Valhalla options forwarded. Nested radius/search_radius/gps_accuracy0..1000; best_paths/top_k1..3. Matrix sources×targets≤2500." }, "example": { "sources": [ { "lat": 12.9716, "lon": 77.5946 } ], "targets": [ { "lat": 12.975, "lon": 77.6 } ], "costing": "auto" } } } } } }, "/api/v1/optimize": { "post": { "operationId": "optimize", "tags": [ "Routing" ], "summary": "Compute optimized_route stop order.", "description": "Required permission: optimize. Provider fields may vary.", "x-required-permissions": [ "optimize" ], "parameters": [], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "trip": { "type": "object", "properties": { "locations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "lat": { "type": "number" }, "lon": { "type": "number" }, "original_index": { "type": "number" } }, "additionalProperties": true } }, "legs": { "type": "array", "items": { "type": "object", "properties": { "maneuvers": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "number" }, "instruction": { "type": "string" }, "verbal_succinct_transition_instruction": { "type": "string" }, "verbal_pre_transition_instruction": { "type": "string" }, "verbal_post_transition_instruction": { "type": "string" }, "bearing_after": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" }, "begin_shape_index": { "type": "number" }, "end_shape_index": { "type": "number" }, "verbal_multi_cue": { "type": "boolean" }, "travel_mode": { "type": "string" }, "travel_type": { "type": "string" } }, "additionalProperties": true } }, "summary": { "type": "object", "properties": { "has_time_restrictions": { "type": "boolean" }, "has_toll": { "type": "boolean" }, "has_highway": { "type": "boolean" }, "has_ferry": { "type": "boolean" }, "min_lat": { "type": "number" }, "min_lon": { "type": "number" }, "max_lat": { "type": "number" }, "max_lon": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" } }, "additionalProperties": true }, "shape": { "type": "string" } }, "additionalProperties": true } }, "summary": { "type": "object", "properties": { "has_time_restrictions": { "type": "boolean" }, "has_toll": { "type": "boolean" }, "has_highway": { "type": "boolean" }, "has_ferry": { "type": "boolean" }, "min_lat": { "type": "number" }, "min_lon": { "type": "number" }, "max_lat": { "type": "number" }, "max_lon": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" } }, "additionalProperties": true }, "status_message": { "type": "string" }, "status": { "type": "number" }, "units": { "type": "string" }, "language": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true }, "example": { "trip": { "locations": [ { "type": "break", "lat": 12.9716, "lon": 77.5946, "original_index": 0 }, { "type": "break", "lat": 12.975, "lon": 77.6, "side_of_street": "right", "original_index": 1 } ], "legs": [ { "maneuvers": [ { "type": 1, "instruction": "Drive east.", "verbal_succinct_transition_instruction": "Drive east. Then Turn left.", "verbal_pre_transition_instruction": "Drive east. Then Turn left.", "verbal_post_transition_instruction": "Continue for 30 meters.", "bearing_after": 112, "time": 11.52, "length": 0.032, "cost": 14.112, "begin_shape_index": 0, "end_shape_index": 2, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left.", "verbal_transition_alert_instruction": "Turn left.", "verbal_succinct_transition_instruction": "Turn left. Then Turn left onto Vittal Mallya Road.", "verbal_pre_transition_instruction": "Turn left. Then Turn left onto Vittal Mallya Road.", "verbal_post_transition_instruction": "Continue for 20 meters.", "bearing_before": 109, "bearing_after": 16, "time": 39.787, "length": 0.019, "cost": 499.32, "begin_shape_index": 2, "end_shape_index": 6, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left onto Vittal Mallya Road.", "verbal_transition_alert_instruction": "Turn left onto Vittal Mallya Road.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left onto Vittal Mallya Road.", "verbal_post_transition_instruction": "Continue for 90 meters.", "street_names": [ "Vittal Mallya Road" ], "bearing_before": 24, "bearing_after": 290, "time": 17.121, "length": 0.093, "cost": 43.831, "begin_shape_index": 6, "end_shape_index": 11, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left onto Kasturba Road.", "verbal_transition_alert_instruction": "Turn left onto Kasturba Road.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left onto Kasturba Road.", "verbal_post_transition_instruction": "Continue for 900 meters.", "street_names": [ "Kasturba Road" ], "bearing_before": 292, "bearing_after": 175, "time": 117.884, "length": 0.858, "cost": 188.3, "begin_shape_index": 11, "end_shape_index": 60, "travel_mode": "drive", "travel_type": "car" }, { "type": 16, "instruction": "Bear left onto Rajaram Mohan Roy Road.", "verbal_transition_alert_instruction": "Bear left onto Rajaram Mohan Roy Road.", "verbal_succinct_transition_instruction": "Bear left.", "verbal_pre_transition_instruction": "Bear left onto Rajaram Mohan Roy Road.", "verbal_post_transition_instruction": "Continue for 200 meters.", "street_names": [ "Rajaram Mohan Roy Road" ], "bearing_before": 114, "bearing_after": 80, "time": 30.924, "length": 0.231, "cost": 49.73, "begin_shape_index": 60, "end_shape_index": 69, "travel_mode": "drive", "travel_type": "car" }, { "type": 16, "instruction": "Bear left onto Residency Road/Field Marshal Cariappa Road.", "verbal_transition_alert_instruction": "Bear left onto Residency Road.", "verbal_succinct_transition_instruction": "Bear left.", "verbal_pre_transition_instruction": "Bear left onto Residency Road, Field Marshal Cariappa Road.", "verbal_post_transition_instruction": "Continue for 900 meters.", "street_names": [ "Residency Road", "Field Marshal Cariappa Road" ], "bearing_before": 67, "bearing_after": 40, "time": 122.334, "length": 0.914, "cost": 169.161, "begin_shape_index": 69, "end_shape_index": 107, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left onto Museum Road.", "verbal_transition_alert_instruction": "Turn left onto Museum Road.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left onto Museum Road.", "verbal_post_transition_instruction": "Continue for 500 meters.", "street_names": [ "Museum Road" ], "bearing_before": 66, "bearing_after": 338, "time": 70.734, "length": 0.476, "cost": 128.341, "begin_shape_index": 107, "end_shape_index": 133, "travel_mode": "drive", "travel_type": "car" }, { "type": 9, "instruction": "Bear right onto Saint Mark's Road.", "verbal_transition_alert_instruction": "Bear right onto Saint Mark's Road.", "verbal_succinct_transition_instruction": "Bear right.", "verbal_pre_transition_instruction": "Bear right onto Saint Mark's Road.", "verbal_post_transition_instruction": "Continue for 200 meters.", "street_names": [ "Saint Mark's Road" ], "bearing_before": 276, "bearing_after": 298, "time": 24.257, "length": 0.164, "cost": 47.054, "begin_shape_index": 133, "end_shape_index": 147, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left.", "verbal_transition_alert_instruction": "Turn left.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left.", "verbal_post_transition_instruction": "Continue for 90 meters.", "bearing_before": 6, "bearing_after": 287, "time": 62.145, "length": 0.086, "cost": 1201.426, "begin_shape_index": 147, "end_shape_index": 152, "travel_mode": "drive", "travel_type": "car" }, { "type": 10, "instruction": "Turn right.", "verbal_transition_alert_instruction": "Turn right.", "verbal_succinct_transition_instruction": "Turn right. Then Turn left.", "verbal_pre_transition_instruction": "Turn right. Then Turn left.", "verbal_post_transition_instruction": "Continue for 10 meters.", "bearing_before": 287, "bearing_after": 10, "time": 8.445, "length": 0.011, "cost": 39.851, "begin_shape_index": 152, "end_shape_index": 154, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left.", "verbal_transition_alert_instruction": "Turn left.", "verbal_succinct_transition_instruction": "Turn left.", "verbal_pre_transition_instruction": "Turn left.", "verbal_post_transition_instruction": "Continue for 50 meters.", "bearing_before": 10, "bearing_after": 278, "time": 21.503, "length": 0.053, "cost": 33.873, "begin_shape_index": 154, "end_shape_index": 156, "travel_mode": "drive", "travel_type": "car" }, { "type": 9, "instruction": "Bear right.", "verbal_transition_alert_instruction": "Bear right.", "verbal_succinct_transition_instruction": "Bear right.", "verbal_pre_transition_instruction": "Bear right.", "verbal_post_transition_instruction": "Continue for 40 meters.", "bearing_before": 271, "bearing_after": 315, "time": 14.734, "length": 0.039, "cost": 25.35, "begin_shape_index": 156, "end_shape_index": 158, "travel_mode": "drive", "travel_type": "car" }, { "type": 5, "instruction": "Your destination is on the right.", "verbal_transition_alert_instruction": "Your destination will be on the right.", "verbal_pre_transition_instruction": "Your destination is on the right.", "bearing_before": 288, "time": 0, "length": 0, "cost": 0, "begin_shape_index": 158, "end_shape_index": 158, "travel_mode": "drive", "travel_type": "car" } ], "summary": { "has_time_restrictions": false, "has_toll": false, "has_highway": false, "has_ferry": false, "min_lat": 12.964998, "min_lon": 77.593994, "max_lat": 12.974866, "max_lon": 77.604807, "time": 541.393, "length": 2.977, "cost": 2440.352 }, "shape": "ogvvWsd__sCvA_FjBgIuAe@eBQm@G_Bk@yFtTm@pBy@lDUr@}EnPlB`FL^x@zApB~Bh@ZjES`Jy@PCdTuClNkBt@IdH{@jC]|ASvIeAfJiAx~@iMvSuClNyAv@KhJaA|u@}JdI_AvASfFu@fASdHq@z@KpCWrGo@v@MlASrHuAbF}@`Eu@bD{@dB_@xAe@lBi@`DqAn@Y|LeH~VmO|IyFnFaEtCkDjA_CfCsF`BcGgAkLg@yA_AiCkAiDg@y@qIyOkb@_k@cKsOUqDYUcBuBiMuNkAuAk@m@_@c@o@s@oAyAsB_CoAwA_WmYyPmS_NsPkJaMqK{OWc@_@q@aCcEwAqEcWkf@y@{AeIyNqL}Q{F_JoD{EoD{EkP{SgAyAy@kA_TuZqAmBEEo^il@cKoV_EsKcJ_VSi@oBaGeDbAgd@fNo@ToErAoBf@kAZeDbAQFwSrHgFbEiB~BaDxGuBnEyClG}AxC}B`FkDlHu@pB_@dBE^q@vM_AxWs@h]KxGk@~VM`Ce@tB_BjCu@h@cB|@aBb@gAJ{@BeAD}E{@yg@aDyBMqDUiBMyEWWlAWnAKf@AH_Kxg@mCW{@MuBrYNjBwBTqD|P" } ], "summary": { "has_time_restrictions": false, "has_toll": false, "has_highway": false, "has_ferry": false, "min_lat": 12.964998, "min_lon": 77.593994, "max_lat": 12.974866, "max_lon": 77.604807, "time": 541.393, "length": 2.977, "cost": 2440.352 }, "status_message": "Found route between points", "status": 0, "units": "kilometers", "language": "en-US" } } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "locations": { "type": "array", "items": { "$ref": "#/components/schemas/PointInput" }, "minItems": 2, "maxItems": 25 }, "costing": { "type": "string", "enum": [ "auto", "bicycle", "pedestrian", "bus", "truck", "motorcycle", "motor_scooter", "taxi", "multimodal", "transit" ] }, "alternates": { "type": "integer", "minimum": 0, "maximum": 2 }, "units": { "type": "string", "description": "Forwarded Valhalla option; examples/default response use kilometers. Read response units." }, "shape_format": { "type": "string", "description": "Forwarded option; default response encoded polyline precision6. Provider support determines other formats." } }, "required": [ "locations", "costing" ], "additionalProperties": true, "not": { "required": [ "encoded_polyline" ] }, "description": "Gateway bounds: depth12,30000nodes,100objectfields,strings4096,arrays2000; additional Valhalla options forwarded. Nested radius/search_radius/gps_accuracy0..1000; best_paths/top_k1..3. Matrix sources×targets≤2500." }, "example": { "locations": [ { "lat": 12.9716, "lon": 77.5946 }, { "lat": 12.975, "lon": 77.6 } ], "costing": "auto" } } } } } }, "/api/v1/snap": { "post": { "operationId": "snap", "tags": [ "Routing" ], "summary": "Map matching via trace_route (not trace_attributes).", "description": "Required permission: snap. Provider fields may vary.", "x-required-permissions": [ "snap" ], "parameters": [], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "trip": { "type": "object", "properties": { "locations": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "lat": { "type": "number" }, "lon": { "type": "number" }, "original_index": { "type": "number" } }, "additionalProperties": true } }, "legs": { "type": "array", "items": { "type": "object", "properties": { "maneuvers": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "number" }, "instruction": { "type": "string" }, "verbal_succinct_transition_instruction": { "type": "string" }, "verbal_pre_transition_instruction": { "type": "string" }, "verbal_post_transition_instruction": { "type": "string" }, "bearing_after": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" }, "begin_shape_index": { "type": "number" }, "end_shape_index": { "type": "number" }, "verbal_multi_cue": { "type": "boolean" }, "travel_mode": { "type": "string" }, "travel_type": { "type": "string" } }, "additionalProperties": true } }, "summary": { "type": "object", "properties": { "has_time_restrictions": { "type": "boolean" }, "has_toll": { "type": "boolean" }, "has_highway": { "type": "boolean" }, "has_ferry": { "type": "boolean" }, "min_lat": { "type": "number" }, "min_lon": { "type": "number" }, "max_lat": { "type": "number" }, "max_lon": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" } }, "additionalProperties": true }, "shape": { "type": "string" } }, "additionalProperties": true } }, "summary": { "type": "object", "properties": { "has_time_restrictions": { "type": "boolean" }, "has_toll": { "type": "boolean" }, "has_highway": { "type": "boolean" }, "has_ferry": { "type": "boolean" }, "min_lat": { "type": "number" }, "min_lon": { "type": "number" }, "max_lat": { "type": "number" }, "max_lon": { "type": "number" }, "time": { "type": "number" }, "length": { "type": "number" }, "cost": { "type": "number" } }, "additionalProperties": true }, "status_message": { "type": "string" }, "status": { "type": "number" }, "units": { "type": "string" }, "language": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true }, "example": { "trip": { "locations": [ { "type": "break", "lat": 12.9716, "lon": 77.5946, "original_index": 0 }, { "type": "break", "lat": 12.975, "lon": 77.6, "original_index": 1 } ], "legs": [ { "maneuvers": [ { "type": 1, "instruction": "Drive north.", "verbal_succinct_transition_instruction": "Drive north. Then Turn left onto Vittal Mallya Road.", "verbal_pre_transition_instruction": "Drive north. Then Turn left onto Vittal Mallya Road.", "verbal_post_transition_instruction": "Continue for 30 meters.", "bearing_after": 12, "time": 41.605, "length": 0.032, "cost": 515.186, "begin_shape_index": 0, "end_shape_index": 5, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 15, "instruction": "Turn left onto Vittal Mallya Road.", "verbal_transition_alert_instruction": "Turn left onto Vittal Mallya Road.", "verbal_succinct_transition_instruction": "Turn left. Then Turn right onto Kasturba Road.", "verbal_pre_transition_instruction": "Turn left onto Vittal Mallya Road. Then Turn right onto Kasturba Road.", "verbal_post_transition_instruction": "Continue for 70 meters.", "street_names": [ "Vittal Mallya Road" ], "bearing_before": 18, "bearing_after": 292, "time": 12.485, "length": 0.067, "cost": 63.346, "begin_shape_index": 5, "end_shape_index": 10, "verbal_multi_cue": true, "travel_mode": "drive", "travel_type": "car" }, { "type": 10, "instruction": "Turn right onto Kasturba Road.", "verbal_transition_alert_instruction": "Turn right onto Kasturba Road.", "verbal_succinct_transition_instruction": "Turn right.", "verbal_pre_transition_instruction": "Turn right onto Kasturba Road.", "verbal_post_transition_instruction": "Continue for 800 meters.", "street_names": [ "Kasturba Road" ], "bearing_before": 310, "bearing_after": 47, "time": 118.297, "length": 0.774, "cost": 225.459, "begin_shape_index": 10, "end_shape_index": 36, "travel_mode": "drive", "travel_type": "car" }, { "type": 10, "instruction": "Turn right onto Lavelle Road/Sri. M. L. Subbaraju Road.", "verbal_transition_alert_instruction": "Turn right onto Lavelle Road.", "verbal_succinct_transition_instruction": "Turn right.", "verbal_pre_transition_instruction": "Turn right onto Lavelle Road, Sri. M. L. Subbaraju Road.", "verbal_post_transition_instruction": "Continue for 200 meters.", "street_names": [ "Lavelle Road", "Sri. M. L. Subbaraju Road" ], "bearing_before": 78, "bearing_after": 177, "time": 37.115, "length": 0.2, "cost": 111.31, "begin_shape_index": 36, "end_shape_index": 47, "travel_mode": "drive", "travel_type": "car" }, { "type": 4, "instruction": "You have arrived at your destination.", "verbal_transition_alert_instruction": "You will arrive at your destination.", "verbal_pre_transition_instruction": "You have arrived at your destination.", "bearing_before": 197, "time": 0, "length": 0, "cost": 0, "begin_shape_index": 47, "end_shape_index": 47, "travel_mode": "drive", "travel_type": "car" } ], "summary": { "has_time_restrictions": false, "has_toll": false, "has_highway": false, "has_ferry": false, "min_lat": 12.971629, "min_lon": 77.59397, "max_lat": 12.9767, "max_lon": 77.599877, "time": 209.503, "length": 1.074, "cost": 915.303 }, "shape": "yevvW}t~~rCoBYqFu@gA@sA_@u@Q}EnPqAlDIXyAlEyBrC_AqAiBuBqKwH_f@w_@gUeQmIkJuFiHwIeLiIcKsJ_MqVs[qE{F}K}N{CmEwFkJcQ_YuPuWgFwHuEgHiUk]cMwOiAmAm@w@yBoCu@{By@uGfDc@pIO`FkBrB{@pKgFbOcI~GuD|DaCzFLvCZbR|D" } ], "summary": { "has_time_restrictions": false, "has_toll": false, "has_highway": false, "has_ferry": false, "min_lat": 12.971629, "min_lon": 77.59397, "max_lat": 12.9767, "max_lon": 77.599877, "time": 209.503, "length": 1.074, "cost": 915.303 }, "status_message": "Found route between points", "status": 0, "units": "kilometers", "language": "en-US" } } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "shape": { "type": "array", "items": { "$ref": "#/components/schemas/PointInput" }, "minItems": 2, "maxItems": 2000 }, "costing": { "type": "string", "enum": [ "auto", "bicycle", "pedestrian", "bus", "truck", "motorcycle", "motor_scooter", "taxi", "multimodal", "transit" ] }, "alternates": { "type": "integer", "minimum": 0, "maximum": 2 }, "units": { "type": "string", "description": "Forwarded Valhalla option; examples/default response use kilometers. Read response units." }, "shape_format": { "type": "string", "description": "Forwarded option; default response encoded polyline precision6. Provider support determines other formats." }, "shape_match": { "type": "string", "description": "Forwarded trace matching mode; tested map_snap." } }, "required": [ "shape", "costing" ], "additionalProperties": true, "not": { "required": [ "encoded_polyline" ] }, "description": "Gateway bounds: depth12,30000nodes,100objectfields,strings4096,arrays2000; additional Valhalla options forwarded. Nested radius/search_radius/gps_accuracy0..1000; best_paths/top_k1..3. Matrix sources×targets≤2500." }, "example": { "shape": [ { "lat": 12.9716, "lon": 77.5946 }, { "lat": 12.975, "lon": 77.6 } ], "costing": "auto", "shape_match": "map_snap" } } } } } }, "/api/v1/nearest-road": { "post": { "operationId": "nearest_road", "tags": [ "Routing" ], "summary": "Locate road candidates via Valhalla locate; not a routed trip.", "description": "Required permission: nearest-road. Provider fields may vary.", "x-required-permissions": [ "nearest-road" ], "parameters": [], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "input_lat": { "type": "number" }, "input_lon": { "type": "number" }, "edges": { "type": "array", "items": { "type": "object", "properties": { "way_id": { "type": "number" }, "correlated_lat": { "type": "number" }, "correlated_lon": { "type": "number" }, "side_of_street": { "type": "string" }, "percent_along": { "type": "number" } }, "additionalProperties": true } }, "nodes": { "type": "array", "items": { "type": "object", "properties": { "lon": { "type": "number" }, "lat": { "type": "number" } }, "additionalProperties": true } } }, "additionalProperties": true } }, "example": [ { "input_lat": 12.9716, "input_lon": 77.5946, "edges": [ { "way_id": 1102326208, "correlated_lat": 12.971656, "correlated_lon": 77.594713, "side_of_street": "neither", "percent_along": 0 }, { "way_id": 1102326208, "correlated_lat": 12.971656, "correlated_lon": 77.594713, "side_of_street": "neither", "percent_along": 1 } ], "nodes": [ { "lon": 77.594713, "lat": 12.971656 } ] } ] } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "locations": { "type": "array", "items": { "$ref": "#/components/schemas/PointInput" }, "minItems": 1, "maxItems": 100 }, "costing": { "type": "string", "enum": [ "auto", "bicycle", "pedestrian", "bus", "truck", "motorcycle", "motor_scooter", "taxi", "multimodal", "transit" ] }, "alternates": { "type": "integer", "minimum": 0, "maximum": 2 }, "units": { "type": "string", "description": "Forwarded Valhalla option; examples/default response use kilometers. Read response units." }, "shape_format": { "type": "string", "description": "Forwarded option; default response encoded polyline precision6. Provider support determines other formats." } }, "required": [ "locations" ], "additionalProperties": true, "not": { "required": [ "encoded_polyline" ] }, "description": "Gateway bounds: depth12,30000nodes,100objectfields,strings4096,arrays2000; additional Valhalla options forwarded. Nested radius/search_radius/gps_accuracy0..1000; best_paths/top_k1..3. Matrix sources×targets≤2500." }, "example": { "locations": [ { "lat": 12.9716, "lon": 77.5946 } ] } } } } } }, "/api/v1/ai/search": { "post": { "operationId": "ai", "tags": [ "Search" ], "summary": "Optional AI intent extraction followed by geocoder search. Implemented, but staging probe currently returns502.", "description": "Required permission: ai. Provider fields may vary.", "x-required-permissions": [ "ai" ], "parameters": [], "responses": { "200": { "description": "Implemented success contract read from source; no successful staging sample available during this audit.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "no-store" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "ai": { "type": "object", "properties": { "intent": { "type": "string", "enum": [ "search", "nearby" ] }, "query": { "type": "string" }, "search_term": { "type": "string" }, "location": { "type": "string" }, "radius": { "type": "number" }, "limit": { "type": "number" } }, "additionalProperties": true }, "location": { "type": [ "object", "null" ], "additionalProperties": true }, "results": { "type": "array", "items": { "$ref": "#/components/schemas/PlaceResult" } } }, "required": [ "query", "ai", "location", "results" ], "additionalProperties": true } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" }, "example": { "error": "Upstream service unavailable" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "query" ], "additionalProperties": true }, "example": { "query": "Find Bengaluru" } } } } } }, "/api/v1/tiles/{source}/{z}/{x}/{y}": { "get": { "operationId": "tile_india", "tags": [ "Maps" ], "summary": "Fetch approved XYZ vector PBF; optional .pbf suffix accepted. No arbitrary Martin/TileJSON paths.", "description": "Required permission: tiles. Provider fields may vary.", "x-required-permissions": [ "tiles" ], "parameters": [ { "name": "source", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "india", "overture", "india,overture", "overture,india" ] } }, { "name": "z", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 0, "maximum": 22 } }, { "name": "x", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 0 } }, { "name": "y", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 0 } } ], "responses": { "200": { "description": "Successful binary vector tile.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, no-store" } }, "content": { "application/x-protobuf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "502": { "description": "Upstream unavailable/rejected/invalid/oversized response. Bounded retry only; explicit application fallback allowed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "504": { "description": "Upstream deadline expired. Bounded retry; request may already have consumed usage.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/divisions/countries": { "get": { "operationId": "countries", "tags": [ "Divisions" ], "summary": "List published countries.", "description": "Required permission: divisions:read. Provider fields may vary.", "x-required-permissions": [ "divisions:read" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Result limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque signed pagination token, max2048. Bound to query/parent/catalog version; never construct or reuse across searches.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, max-age=300 (pinned geometry: private, max-age=86400, immutable)" }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "Server-Timing": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DivisionPage" }, "example": { "items": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "local_name": "ಭಾರತ", "type": "COUNTRY", "subtype": null, "source_local_type": { "en": "country" }, "source_original_type": "country", "source_admin_level": 0, "parent_id": null, "country_code": "IN", "state_code": null, "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" } ], "source": "OVERTURE", "source_external_id": "c3edf10a-fe23-4c7e-a777-52199ac7df8e", "source_dataset_version": "2026-08-19.0", "source_feature_version": "6", "source_updated_at": "2026-07-22T20:47:10.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 68.4328078, 6.757237, 97.3950905, 35.6729307 ], "area": 3149957118479.4375, "area_unit": "m2", "geometry_version": "01769867-41f9-4c47-8f27-acfdeb5a7587", "status": "SUPPORTED", "coverage": "validated_states_districts_partial", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } } ], "has_more": false, "next_cursor": null, "catalog_version": "4" } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Retry-After": { "schema": { "type": "string" }, "example": "60", "description": "Fixed60seconds for rate/quota/concurrency; not a monthly quota reset promise." } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/divisions/countries/{countryCode}/children": { "get": { "operationId": "states", "tags": [ "Divisions" ], "summary": "List direct children of a country; IN returns36States/UTs.", "description": "Required permission: divisions:read. Provider fields may vary.", "x-required-permissions": [ "divisions:read" ], "parameters": [ { "name": "countryCode", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Z]{2}$" } }, { "name": "limit", "in": "query", "required": false, "description": "Result limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque signed pagination token, max2048. Bound to query/parent/catalog version; never construct or reuse across searches.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, max-age=300 (pinned geometry: private, max-age=86400, immutable)" }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "Server-Timing": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DivisionPage" }, "example": { "items": [ { "id": "8be34199-7308-47d0-91b8-6e268447beb7", "name": "Andaman and Nicobar Islands", "local_name": "अण्डमान और निकोबार द्वीपसमूह", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-AN", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "8be34199-7308-47d0-91b8-6e268447beb7", "name": "Andaman and Nicobar Islands", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "c1d41d4d-842a-44c1-ac70-71dfaede077c", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-23T05:35:21.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 92.2042072, 6.7562674, 94.2773214, 13.6753133 ], "area": 7410661401.902759, "area_unit": "m2", "geometry_version": "ed2a53ba-f037-4400-a906-c789b4586784", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "51d2077b-6b06-4fda-aad5-503599763aab", "name": "Andhra Pradesh", "local_name": "ఆంధ్ర ప్రదేశ్", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-AP", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "51d2077b-6b06-4fda-aad5-503599763aab", "name": "Andhra Pradesh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "d2d77b02-0c8a-4469-b678-35fd3a2673ff", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-18T17:08:46.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 76.7600837, 12.6238599, 84.7658033, 19.166806 ], "area": 163057775488.98767, "area_unit": "m2", "geometry_version": "eb667887-1bf4-409e-b9c8-2d20d1321a67", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "9afea960-fb61-4677-99a6-eea4197b9086", "name": "Arunachal Pradesh", "local_name": null, "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-AR", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "9afea960-fb61-4677-99a6-eea4197b9086", "name": "Arunachal Pradesh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "61a3db52-e7fb-4c4a-8f25-ffc8b6b1067d", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-07-16T12:14:38.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 91.5623082, 26.650863, 97.3950905, 29.3745566 ], "area": 83119809367.95004, "area_unit": "m2", "geometry_version": "2f66622f-440c-43a9-87e3-827a9e596520", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "47fcb479-3544-4876-992e-102db13a0838", "name": "Assam", "local_name": "অসম", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-AS", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "47fcb479-3544-4876-992e-102db13a0838", "name": "Assam", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "73578ee5-b9a8-418f-8916-568234e42f27", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-07-06T17:12:57.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 89.6986005, 24.136033, 96.0124397, 27.9712428 ], "area": 78511963861.89667, "area_unit": "m2", "geometry_version": "d3ded809-f4be-453a-ab87-66f6c79e5bf1", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "ed4cb8e6-fcfb-4811-97bd-31e6d3012888", "name": "Bihar", "local_name": "बिहार", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-BR", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "ed4cb8e6-fcfb-4811-97bd-31e6d3012888", "name": "Bihar", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "de64812a-8d94-432f-902e-9437746b0ba7", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-04T20:24:32.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 83.3212566, 24.2857164, 88.2937958, 27.521635 ], "area": 94155477766.92343, "area_unit": "m2", "geometry_version": "8c79af04-0994-4ff8-98d3-b2ddc46ba148", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "6940dfa0-7037-4de1-a890-04e8fd92b737", "name": "Chandigarh", "local_name": "ਚੰਡੀਗੜ੍ਹ", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-CH", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "6940dfa0-7037-4de1-a890-04e8fd92b737", "name": "Chandigarh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "04efc0a7-6819-4fbd-8c06-ba34447368cf", "source_dataset_version": "2026-08-19.0", "source_feature_version": "2", "source_updated_at": "2026-01-18T19:57:53.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 76.7049857, 30.664974, 76.849028, 30.7949512 ], "area": 116418749.33196834, "area_unit": "m2", "geometry_version": "e89d8202-1005-4d42-bb35-11770e120821", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "c09428dd-dded-4e3e-91d8-fcb54d69fb2d", "name": "Chhattisgarh", "local_name": "छत्तीसगढ़", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-CG", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "c09428dd-dded-4e3e-91d8-fcb54d69fb2d", "name": "Chhattisgarh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "d2f2b84b-dfaf-4760-836a-a3f39cc9ac2a", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2025-12-16T18:50:00.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 80.2441803, 17.7822157, 84.3959641, 24.1066864 ], "area": 135143697603.58925, "area_unit": "m2", "geometry_version": "01a17950-f109-49c3-aeb4-1b15970e812c", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "0bf13793-4c52-490b-b1db-d5211e6ea28d", "name": "Dadra and Nagar Haveli and Daman and Diu", "local_name": "દાદરા અને નગર હવેલી અને દમણ અને દીવ", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-DH", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "0bf13793-4c52-490b-b1db-d5211e6ea28d", "name": "Dadra and Nagar Haveli and Daman and Diu", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "9e12a993-9d35-4eea-9a12-7ef5cff37ce1", "source_dataset_version": "2026-08-19.0", "source_feature_version": "2", "source_updated_at": "2026-02-28T19:09:32.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 70.8734588, 20.0473907, 73.2178258, 20.7677936 ], "area": 600753197.1042653, "area_unit": "m2", "geometry_version": "249e93da-3408-4ab5-a1a1-592cfabd04f1", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "cc31ba58-2840-4848-89a1-104448315a18", "name": "Delhi", "local_name": "दिल्ली", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-DL", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "cc31ba58-2840-4848-89a1-104448315a18", "name": "Delhi", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "fca7c08d-d6a3-4866-99fe-573ec74a8510", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-23T12:47:12.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 76.8388351, 28.4046285, 77.3452524, 28.8834464 ], "area": 1481803003.1470137, "area_unit": "m2", "geometry_version": "4ecb1a3c-b649-4463-934b-5dd2a2b174c6", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "fe8f0b46-cfd7-46ef-bb1e-6208359c1573", "name": "Goa", "local_name": "गोंय", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-GA", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "fe8f0b46-cfd7-46ef-bb1e-6208359c1573", "name": "Goa", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "f97c2c5a-ce37-4f17-a62d-6fc2a0117c39", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-05-31T05:37:04.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 73.6756012, 14.7529315, 74.3361139, 15.8007631 ], "area": 3635229593.136543, "area_unit": "m2", "geometry_version": "c153960b-7d3e-4f4c-993e-63a915d7549f", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "df83ce4b-1cee-4b26-8bc6-7c19d5b60149", "name": "Gujarat", "local_name": "ગુજરાત", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-GJ", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "df83ce4b-1cee-4b26-8bc6-7c19d5b60149", "name": "Gujarat", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "cc99fb60-7eaf-4cf1-9e38-a90a9c5f78fc", "source_dataset_version": "2026-08-19.0", "source_feature_version": "2", "source_updated_at": "2026-07-07T10:11:05.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 68.4328078, 20.1195321, 74.4764325, 24.7118932 ], "area": 182263795084.71307, "area_unit": "m2", "geometry_version": "9b51373f-b91a-4228-b254-6150b2255dbe", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "5be44d46-417f-4eaa-b0ef-7a265c42df85", "name": "Haryana", "local_name": "हरियाणा", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-HR", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "5be44d46-417f-4eaa-b0ef-7a265c42df85", "name": "Haryana", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "7438cf9e-c636-41e6-9be4-ca1a426e82c3", "source_dataset_version": "2026-08-19.0", "source_feature_version": "2", "source_updated_at": "2026-07-23T12:47:12.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 74.4735074, 27.6526273, 77.6021432, 30.9287706 ], "area": 44200765365.85719, "area_unit": "m2", "geometry_version": "98cf9c7d-8f4e-4f01-847b-26e0da3ebbdb", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "c759ced5-b88d-44d9-ad3c-dd619db5a786", "name": "Himachal Pradesh", "local_name": "हिमाचल प्रदेश", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-HP", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "c759ced5-b88d-44d9-ad3c-dd619db5a786", "name": "Himachal Pradesh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "5a0eac60-0cc9-4e2b-a9e2-3f338bbb1cbf", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-04T07:49:45.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 75.5940055, 30.3771701, 78.99265, 33.2556686 ], "area": 55316648551.94468, "area_unit": "m2", "geometry_version": "60e42fef-556e-4f02-b7dc-3bb5e9b9576a", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "73a60166-0e7a-4f70-bf8c-2447d140d196", "name": "Jammu and Kashmir", "local_name": "جموں و کشمیر", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-JK", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "73a60166-0e7a-4f70-bf8c-2447d140d196", "name": "Jammu and Kashmir", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "d075d117-b3b2-4d1a-92c6-ad24ba7de31c", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-04T07:49:45.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 73.7500338, 32.2763569, 76.7803165, 34.7871414 ], "area": 42196041835.555664, "area_unit": "m2", "geometry_version": "bd5fc9a9-cfbd-4650-aafc-f9da39e68248", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "c2faba07-1b9a-42f3-a7cf-75251bc59a28", "name": "Jharkhand", "local_name": "झारखण्ड", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-JH", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "c2faba07-1b9a-42f3-a7cf-75251bc59a28", "name": "Jharkhand", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "bf42385c-4926-4b08-9a2c-7760a31dd0a0", "source_dataset_version": "2026-08-19.0", "source_feature_version": "2", "source_updated_at": "2026-01-18T19:36:39.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 83.3281137, 21.9700317, 87.9628253, 25.3489225 ], "area": 79874035513.96161, "area_unit": "m2", "geometry_version": "a2156a64-ff5d-4abb-a36b-78ea829925a5", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "918dd81f-b001-46a4-a853-954b2550230a", "name": "Karnataka", "local_name": "ಕರ್ನಾಟಕ", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-KA", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "918dd81f-b001-46a4-a853-954b2550230a", "name": "Karnataka", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "94650b04-0a86-416b-9594-13e0409d1bea", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-07-22T09:36:29.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 74.0543908, 11.5945587, 78.5875761, 18.4766494 ], "area": 191819680529.20346, "area_unit": "m2", "geometry_version": "90e165f0-5a2a-4796-b58b-b57e542e738b", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "d16e4894-13eb-44f5-b21b-96863490ba03", "name": "Kerala", "local_name": "കേരളം", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-KL", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "d16e4894-13eb-44f5-b21b-96863490ba03", "name": "Kerala", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "dc139c38-f4ef-4348-af89-d248984dd6f3", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-23T08:47:10.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 74.8640682, 8.2935318, 77.4123612, 12.7960559 ], "area": 38866428830.45127, "area_unit": "m2", "geometry_version": "515202c9-b6dd-43b6-8acd-024383efc664", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "d1a5b367-781f-451e-aeab-3870f627007e", "name": "Ladakh", "local_name": "ལ་དྭགས", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-LA", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "d1a5b367-781f-451e-aeab-3870f627007e", "name": "Ladakh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "25d3e952-153e-4549-826e-6ba85b403a94", "source_dataset_version": "2026-08-19.0", "source_feature_version": "6", "source_updated_at": "2026-07-14T05:13:46.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 75.3269726, 32.33574, 79.305851, 35.6729307 ], "area": 64472893968.79444, "area_unit": "m2", "geometry_version": "6dcfbf4f-a337-4770-bb7b-74c7b85938e4", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "fbcd5c1d-2929-44b9-9e3c-dcf4bcb8abca", "name": "Lakshadweep", "local_name": "ലക്ഷദ്വീപ്", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-LD", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "fbcd5c1d-2929-44b9-9e3c-dcf4bcb8abca", "name": "Lakshadweep", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "1fb4e671-415d-435a-937c-0966f9cf9a91", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2025-12-16T18:50:00.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": false, "has_geometry": true, "bbox": [ 72.1736211, 8.26649, 73.7026915, 11.7057212 ], "area": 26714244.2133861, "area_unit": "m2", "geometry_version": "92b389b3-8e1c-4bbc-8421-0938551b5df4", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "c2dbe145-0a38-4366-8915-b99697812e91", "name": "Madhya Pradesh", "local_name": "मध्य प्रदेश", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-MP", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "c2dbe145-0a38-4366-8915-b99697812e91", "name": "Madhya Pradesh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "e824f4a7-4fab-4b8a-bbd2-0565d76b069b", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-18T16:10:57.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 74.029382, 21.0706885, 82.8126116, 26.8695616 ], "area": 308214715782.1623, "area_unit": "m2", "geometry_version": "e1c43faa-57c4-4181-8102-b9f90313245a", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "c44b1385-5fbb-4cc5-b075-dcab85a43760", "name": "Maharashtra", "local_name": "महाराष्ट्र", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-MH", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "c44b1385-5fbb-4cc5-b075-dcab85a43760", "name": "Maharashtra", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "63a05035-b757-4349-82f2-e7a379ed36dc", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-15T17:47:15.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 72.6526112, 15.6063596, 80.8977842, 22.0302694 ], "area": 307249932689.5917, "area_unit": "m2", "geometry_version": "d86e2856-0db7-4c59-a2e4-42f45e126a65", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "130ce84d-46ae-477d-a18b-d64fec8b003a", "name": "Manipur", "local_name": null, "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-MN", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "130ce84d-46ae-477d-a18b-d64fec8b003a", "name": "Manipur", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "6bbb783d-6c9d-4da8-8cf3-51e33f1018ba", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-22T20:47:10.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 92.9707074, 23.8336205, 94.745244, 25.6921015 ], "area": 22349913191.00523, "area_unit": "m2", "geometry_version": "3657eb26-644d-48b8-95e8-c1e6ff08308f", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "d8a3a602-6ce1-42b3-aa0f-c057d007768d", "name": "Meghalaya", "local_name": null, "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-ML", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "d8a3a602-6ce1-42b3-aa0f-c057d007768d", "name": "Meghalaya", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "05717c8a-b1db-464d-abee-d0b2f08701b8", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-04-24T17:23:46.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 89.814444, 25.0306475, 92.8027367, 26.1181651 ], "area": 22388084739.836693, "area_unit": "m2", "geometry_version": "e7eb08e6-afe5-4815-8c50-b87d0acfb4c3", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "0b2cf07d-117e-4fd7-a46c-d5bcdae6f427", "name": "Mizoram", "local_name": null, "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-MZ", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "0b2cf07d-117e-4fd7-a46c-d5bcdae6f427", "name": "Mizoram", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "3e488c2f-c904-4eae-87b9-631e3954faa6", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-06-21T20:17:15.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 92.2602224, 21.9400528, 93.4373696, 24.5231304 ], "area": 21067800857.88299, "area_unit": "m2", "geometry_version": "a3ba13ab-c6ea-4af5-8c5d-90ec847ba91a", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "043a2679-2be6-49e7-a3be-8a984d54e2a8", "name": "Nagaland", "local_name": null, "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-NL", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "043a2679-2be6-49e7-a3be-8a984d54e2a8", "name": "Nagaland", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "e41409ac-7850-41cd-a4ec-4c6113b653a2", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-04-05T20:48:00.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 93.3267005, 25.1984274, 95.2423775, 27.035801 ], "area": 16563118905.847075, "area_unit": "m2", "geometry_version": "82d0cc3d-7e21-4e7f-ad4d-2d1d99651c29", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "f854cf88-2421-460c-868e-97d5c7493a18", "name": "Odisha", "local_name": "ଓଡ଼ିଶା", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-OD", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "f854cf88-2421-460c-868e-97d5c7493a18", "name": "Odisha", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "8f0f2ba2-f6ab-4089-b28d-334da6354a35", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-04-01T22:24:08.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 81.3885855, 17.8122733, 87.4861351, 22.5675932 ], "area": 155514901839.42596, "area_unit": "m2", "geometry_version": "789d53cc-92b3-412c-b99d-2ff026218b4c", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "ef57e301-8ef6-4d35-b0fc-72da592816e5", "name": "Puducherry", "local_name": "புதுச்சேரி", "type": "STATE", "subtype": "UNION_TERRITORY", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-PY", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "ef57e301-8ef6-4d35-b0fc-72da592816e5", "name": "Puducherry", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "37565568-eb20-4a8f-9d5a-d4ec83f75f89", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-02-17T07:32:39.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 75.5265863, 10.827721, 82.3137136, 16.7617112 ], "area": 493874691.47602016, "area_unit": "m2", "geometry_version": "ff2fa7a0-b9ff-4525-bc73-1d77d2351c3f", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "8eef6653-68a0-4056-8713-80770204b20f", "name": "Punjab", "local_name": "ਪੰਜਾਬ", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-PB", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "8eef6653-68a0-4056-8713-80770204b20f", "name": "Punjab", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "84e16dfb-8b1a-4e7e-bd6e-5862240a7fc2", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-01T12:32:51.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 73.8798336, 29.5429378, 76.9390583, 32.5111793 ], "area": 50334250435.47752, "area_unit": "m2", "geometry_version": "a2f6d073-2f87-4db7-914f-3e62a09f1cf6", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "78c7a0e8-9038-4ff0-ad46-1a3dc8e8e09c", "name": "Rajasthan", "local_name": "राजस्थान", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-RJ", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "78c7a0e8-9038-4ff0-ad46-1a3dc8e8e09c", "name": "Rajasthan", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "e6cf8499-0200-4d48-a9cd-74c383ac5d8c", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-01-18T19:59:42.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 69.4844368, 23.0586612, 78.2720089, 30.198253 ], "area": 342222368001.70557, "area_unit": "m2", "geometry_version": "2d2157c0-57a2-42de-a18a-ce174a40b8aa", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "547d48a7-17e0-4cea-a7b2-ad7577576018", "name": "Sikkim", "local_name": "सिक्किम", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-SK", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "547d48a7-17e0-4cea-a7b2-ad7577576018", "name": "Sikkim", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "5fa67e56-5de3-42df-b763-0d60f953fd9a", "source_dataset_version": "2026-08-19.0", "source_feature_version": "6", "source_updated_at": "2026-07-20T11:34:03.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 88.0120333, 27.0792596, 88.9211683, 28.1240465 ], "area": 7105733887.398931, "area_unit": "m2", "geometry_version": "8220f07c-8191-4231-8d50-0858a306f158", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "d467fce5-9975-4c4f-819d-65544db1126d", "name": "Tamil Nadu", "local_name": "தமிழ்நாடு", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-TN", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "d467fce5-9975-4c4f-819d-65544db1126d", "name": "Tamil Nadu", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "a45ac7ba-2823-41bd-85d0-8612b21720ae", "source_dataset_version": "2026-08-19.0", "source_feature_version": "4", "source_updated_at": "2026-07-23T08:47:10.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 76.2329467, 8.0768938, 80.3592991, 13.5639111 ], "area": 130071694863.24918, "area_unit": "m2", "geometry_version": "b037bf67-041f-4a6e-8aea-a74f6f203777", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "f18f4616-8bac-4699-a960-6c9b5ca61ee5", "name": "Telangana", "local_name": "తెలంగాణ", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-TS", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "f18f4616-8bac-4699-a960-6c9b5ca61ee5", "name": "Telangana", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "0f18d4f3-052d-47f5-b9f0-22e0eb1eef8a", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-05-29T08:58:47.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 77.236585, 15.8364246, 81.3226246, 19.9172962 ], "area": 112090433898.17992, "area_unit": "m2", "geometry_version": "d8395e85-a284-44df-9022-1fe1320dac49", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "8fb7eec4-78ea-4ed8-9098-12df8fd58c66", "name": "Tripura", "local_name": "ত্রিপুরা", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-TR", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "8fb7eec4-78ea-4ed8-9098-12df8fd58c66", "name": "Tripura", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "af417450-5b20-480d-8cc8-6076526e5a0c", "source_dataset_version": "2026-08-19.0", "source_feature_version": "2", "source_updated_at": "2026-01-06T09:25:43.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 91.1508098, 22.9376106, 92.33585, 24.530878 ], "area": 10353070683.698431, "area_unit": "m2", "geometry_version": "d514c634-dfce-42ea-8b99-f0720212d2c4", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "87f40021-d7f7-4df8-b1e8-7bba7b5eb8cd", "name": "Uttar Pradesh", "local_name": "उत्तर प्रदेश", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-UP", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "87f40021-d7f7-4df8-b1e8-7bba7b5eb8cd", "name": "Uttar Pradesh", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "3cdb074f-29f7-45cf-9ff9-041487e0f988", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-07-18T16:10:57.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 77.0838761, 23.8706272, 84.6345091, 30.4063828 ], "area": 241029421988.03546, "area_unit": "m2", "geometry_version": "5afab736-8497-4d3d-8068-7bbe941b9e5b", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "249abcc7-ea47-4afc-8d04-8710562cc517", "name": "Uttarakhand", "local_name": "उत्तराखण्ड", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-UK", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "249abcc7-ea47-4afc-8d04-8710562cc517", "name": "Uttarakhand", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "bfd9d943-c763-4f13-afd3-2f1e1eafe7bc", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-04-10T13:26:37.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 77.57133, 28.7243243, 81.044789, 31.2850755 ], "area": 51151966114.788864, "area_unit": "m2", "geometry_version": "479dd0eb-852b-4a06-a408-71cd83d5c52b", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } }, { "id": "d2e8fbcb-d4a5-4563-b23c-d0f46153c813", "name": "West Bengal", "local_name": "পশ্চিমবঙ্গ", "type": "STATE", "subtype": "STATE", "source_local_type": { "en": "state" }, "source_original_type": "region", "source_admin_level": 1, "parent_id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "country_code": "IN", "state_code": "IN-WB", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "d2e8fbcb-d4a5-4563-b23c-d0f46153c813", "name": "West Bengal", "type": "STATE" } ], "source": "OVERTURE", "source_external_id": "4613df03-e50b-464f-925c-6ae723f6c954", "source_dataset_version": "2026-08-19.0", "source_feature_version": "3", "source_updated_at": "2026-07-11T14:04:44.000Z", "synced_at": "2026-09-28T14:27:08.998Z", "has_children": true, "has_geometry": true, "bbox": [ 85.8196735, 21.5473014, 89.8826022, 27.2210674 ], "area": 85339055555.03516, "area_unit": "m2", "geometry_version": "c9a525d9-11bd-4dcd-bdb1-c5204f7de6dc", "status": "SUPPORTED", "coverage": "validated_districts_only_taluks_not_complete", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors, Overture Maps Foundation", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } } ], "has_more": false, "next_cursor": null, "catalog_version": "4" } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Retry-After": { "schema": { "type": "string" }, "example": "60", "description": "Fixed60seconds for rate/quota/concurrency; not a monthly quota reset promise." } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/divisions/search": { "get": { "operationId": "division_search", "tags": [ "Divisions" ], "summary": "Case-normalized substring search over approved canonical/local/alternate names.", "description": "Required permission: divisions:read. Provider fields may vary.", "x-required-permissions": [ "divisions:read" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "After NFKC/case/whitespace normalization2..128Unicodecodepoints; raw≤256codeunits/512UTF8bytes, no control/format characters.", "schema": { "type": "string", "minLength": 2, "maxLength": 128 } }, { "name": "limit", "in": "query", "required": false, "description": "Result limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque signed pagination token, max2048. Bound to query/parent/catalog version; never construct or reuse across searches.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, max-age=300 (pinned geometry: private, max-age=86400, immutable)" }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "Server-Timing": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DivisionPage" }, "example": { "items": [ { "id": "e1fed2f5-db16-43c9-98da-a26039e31f9a", "name": "Gubbi taluk", "local_name": "ಗುಬ್ಬಿ ತಾಲೂಕು", "type": "TALUK", "subtype": null, "source_local_type": null, "source_original_type": "boundary=administrative;type=boundary", "source_admin_level": 6, "parent_id": "2d5b0fe2-ebd1-4ae7-895e-fcfe998bfd10", "country_code": "IN", "state_code": "IN-KA", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "918dd81f-b001-46a4-a853-954b2550230a", "name": "Karnataka", "type": "STATE" }, { "id": "2d5b0fe2-ebd1-4ae7-895e-fcfe998bfd10", "name": "Tumakuru", "type": "DISTRICT" }, { "id": "e1fed2f5-db16-43c9-98da-a26039e31f9a", "name": "Gubbi taluk", "type": "TALUK" } ], "source": "OSM", "source_external_id": "4451597", "source_dataset_version": "osm-snapshot:2026-09-04T20:21:21Z", "source_feature_version": "4", "source_updated_at": "2025-12-16T18:09:53.000Z", "synced_at": "2026-09-28T08:39:29.747Z", "has_children": false, "has_geometry": true, "bbox": [ 76.6972269, 13.089114, 77.0057434, 13.590223 ], "area": 1211779872.4813528, "area_unit": "m2", "geometry_version": "d93d31d2-80a1-4d5f-a48c-9ce5fde8264e", "status": "SOURCE_FALLBACK", "coverage": "validated_tumakuru_taluk", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } } ], "has_more": false, "next_cursor": null, "catalog_version": "4" } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Retry-After": { "schema": { "type": "string" }, "example": "60", "description": "Fixed60seconds for rate/quota/concurrency; not a monthly quota reset promise." } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/divisions/{division_id}": { "get": { "operationId": "division_detail", "tags": [ "Divisions" ], "summary": "Read lightweight metadata; no embedded geometry.", "description": "Required permission: divisions:read. Provider fields may vary.", "x-required-permissions": [ "divisions:read" ], "parameters": [ { "name": "division_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, max-age=300 (pinned geometry: private, max-age=86400, immutable)" }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "Server-Timing": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DivisionMetadata" }, "example": { "id": "e1fed2f5-db16-43c9-98da-a26039e31f9a", "name": "Gubbi taluk", "local_name": "ಗುಬ್ಬಿ ತಾಲೂಕು", "type": "TALUK", "subtype": null, "source_local_type": null, "source_original_type": "boundary=administrative;type=boundary", "source_admin_level": 6, "parent_id": "2d5b0fe2-ebd1-4ae7-895e-fcfe998bfd10", "country_code": "IN", "state_code": "IN-KA", "breadcrumb": [ { "id": "1c3d6442-1d1f-45f8-8364-5c57b4d20c2d", "name": "India", "type": "COUNTRY" }, { "id": "918dd81f-b001-46a4-a853-954b2550230a", "name": "Karnataka", "type": "STATE" }, { "id": "2d5b0fe2-ebd1-4ae7-895e-fcfe998bfd10", "name": "Tumakuru", "type": "DISTRICT" }, { "id": "e1fed2f5-db16-43c9-98da-a26039e31f9a", "name": "Gubbi taluk", "type": "TALUK" } ], "source": "OSM", "source_external_id": "4451597", "source_dataset_version": "osm-snapshot:2026-09-04T20:21:21Z", "source_feature_version": "4", "source_updated_at": "2025-12-16T18:09:53.000Z", "synced_at": "2026-09-28T08:39:29.747Z", "has_children": false, "has_geometry": true, "bbox": [ 76.6972269, 13.089114, 77.0057434, 13.590223 ], "area": 1211779872.4813528, "area_unit": "m2", "geometry_version": "d93d31d2-80a1-4d5f-a48c-9ce5fde8264e", "status": "SOURCE_FALLBACK", "coverage": "validated_tumakuru_taluk", "ambiguity_reason": null, "attribution": { "text": "© OpenStreetMap contributors", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Retry-After": { "schema": { "type": "string" }, "example": "60", "description": "Fixed60seconds for rate/quota/concurrency; not a monthly quota reset promise." } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/divisions/{division_id}/children": { "get": { "operationId": "division_children", "tags": [ "Divisions" ], "summary": "List direct children, not recursive descendants.", "description": "Required permission: divisions:read. Provider fields may vary.", "x-required-permissions": [ "divisions:read" ], "parameters": [ { "name": "division_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "limit", "in": "query", "required": false, "description": "Result limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque signed pagination token, max2048. Bound to query/parent/catalog version; never construct or reuse across searches.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, max-age=300 (pinned geometry: private, max-age=86400, immutable)" }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "Server-Timing": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DivisionPage" }, "example": { "items": [], "has_more": false, "next_cursor": null, "catalog_version": "4" } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Retry-After": { "schema": { "type": "string" }, "example": "60", "description": "Fixed60seconds for rate/quota/concurrency; not a monthly quota reset promise." } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } }, "/api/v1/divisions/{division_id}/geometry": { "get": { "operationId": "division_geometry", "tags": [ "Divisions" ], "summary": "Read approved immutable/current GeoJSON boundary; authenticate before conditional304.", "description": "Required permission: divisions:geometry. Provider fields may vary.", "x-required-permissions": [ "divisions:geometry" ], "parameters": [ { "name": "division_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "version", "in": "query", "required": false, "description": "Pin immutable geometry revision UUID (not source dataset date).", "schema": { "type": "string", "format": "uuid" } }, { "name": "If-None-Match", "in": "header", "schema": { "type": "string" }, "description": "Previously returned ETag, preserve quotes. Authorization still required." } ], "responses": { "200": { "description": "Successful response. Provider fields can vary; sample is a staging observation.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, max-age=300 (pinned geometry: private, max-age=86400, immutable)" }, "ETag": { "schema": { "type": "string" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "Server-Timing": { "schema": { "type": "string" } } }, "content": { "application/geo+json": { "schema": { "$ref": "#/components/schemas/BoundaryFeature" }, "example": { "type": "Feature", "id": "e1fed2f5-db16-43c9-98da-a26039e31f9a", "bbox": [ 76.6972269, 13.089114, 77.0057434, 13.590223 ], "geometry": { "type": "Polygon", "coordinates": [ [ [ 76.6972269, 13.536427 ], [ 76.713977, 13.51132 ], [ 76.7220488, 13.5076568 ], [ 76.7286333, 13.5049863 ], [ 76.7316576, 13.4748989 ], [ 76.7272374, 13.4629081 ], [ 76.7370083, 13.4561205 ], [ 76.757248, 13.4475228 ], [ 76.7577132, 13.4414136 ], [ 76.7509667, 13.4346255 ], [ 76.7511993, 13.4282897 ], [ 76.757248, 13.4215013 ], [ 76.760439, 13.4158203 ], [ 76.7367757, 13.4099604 ], [ 76.7272773, 13.4048509 ], [ 76.7281828, 13.3914027 ], [ 76.7187501, 13.3879692 ], [ 76.7083379, 13.3887829 ], [ 76.7129676, 13.379707 ], [ 76.7124319, 13.3719457 ], [ 76.7086327, 13.363802 ], [ 76.7077521, 13.3515535 ], [ 76.7211247, 13.3424882 ], [ 76.7166424, 13.3304304 ], [ 76.7101028, 13.3294195 ], [ 76.7117565, 13.3149884 ], [ 76.7178555, 13.3129748 ], [ 76.7180347, 13.3078459 ], [ 76.7247333, 13.3072294 ], [ 76.741408, 13.3060758 ], [ 76.7460896, 13.2942506 ], [ 76.7625449, 13.2948369 ], [ 76.7662671, 13.2855541 ], [ 76.7766813, 13.2799469 ], [ 76.781854, 13.2685725 ], [ 76.8024378, 13.2682439 ], [ 76.8034895, 13.2570243 ], [ 76.8058182, 13.2463196 ], [ 76.8239618, 13.2459285 ], [ 76.8252491, 13.2541331 ], [ 76.8317852, 13.2546047 ], [ 76.8330698, 13.2461321 ], [ 76.8369456, 13.2447763 ], [ 76.836885, 13.234755 ], [ 76.8397908, 13.2347517 ], [ 76.840836, 13.2254817 ], [ 76.833736, 13.2221392 ], [ 76.8328021, 13.2171675 ], [ 76.8155866, 13.2145344 ], [ 76.8139583, 13.2117321 ], [ 76.798604, 13.2067494 ], [ 76.8068336, 13.1661075 ], [ 76.8044034, 13.1594372 ], [ 76.8270073, 13.1576774 ], [ 76.8298048, 13.1389648 ], [ 76.8367941, 13.1378921 ], [ 76.8395334, 13.1346835 ], [ 76.8492196, 13.1326002 ], [ 76.8498952, 13.1269393 ], [ 76.8591726, 13.128582 ], [ 76.8653174, 13.1159094 ], [ 76.8742696, 13.1085155 ], [ 76.8938998, 13.1086646 ], [ 76.9018961, 13.1104735 ], [ 76.9126172, 13.1000101 ], [ 76.9197097, 13.0954739 ], [ 76.9320226, 13.0904735 ], [ 76.9359775, 13.0950054 ], [ 76.9592415, 13.0954586 ], [ 76.9652901, 13.0897938 ], [ 76.9715714, 13.089114 ], [ 76.9836686, 13.095232 ], [ 76.9662207, 13.108827 ], [ 76.9683144, 13.1226478 ], [ 76.9857995, 13.1292249 ], [ 76.9818506, 13.1349607 ], [ 76.9802428, 13.1631192 ], [ 76.9824294, 13.1775065 ], [ 76.9753573, 13.1787491 ], [ 76.9804754, 13.1980018 ], [ 76.9795218, 13.2051264 ], [ 76.9871698, 13.2073939 ], [ 76.9837112, 13.231242 ], [ 76.9883332, 13.2376807 ], [ 76.9956739, 13.237314 ], [ 76.9948394, 13.2403195 ], [ 76.9903815, 13.2424893 ], [ 76.9899553, 13.2496198 ], [ 76.997535, 13.2515218 ], [ 76.9941012, 13.2673183 ], [ 76.9857428, 13.2663549 ], [ 76.9838343, 13.2610766 ], [ 76.979357, 13.2609018 ], [ 76.9826101, 13.2710457 ], [ 76.9773428, 13.2736332 ], [ 76.9868727, 13.2891575 ], [ 76.9871265, 13.2996857 ], [ 76.997792, 13.3013484 ], [ 77.0020083, 13.3155449 ], [ 77.0057434, 13.334245 ], [ 77.0021109, 13.3463109 ], [ 76.9929809, 13.3501671 ], [ 76.9916421, 13.3580811 ], [ 76.99337, 13.3670139 ], [ 76.9969678, 13.3813811 ], [ 76.9948991, 13.3979147 ], [ 76.9974901, 13.4051247 ], [ 76.9883332, 13.4080548 ], [ 76.989781, 13.4275593 ], [ 76.9757405, 13.4451066 ], [ 76.974892, 13.4691912 ], [ 76.9689699, 13.4856393 ], [ 76.9600585, 13.4904527 ], [ 76.9427373, 13.4925731 ], [ 76.9350737, 13.4901475 ], [ 76.9231277, 13.4918126 ], [ 76.9212761, 13.5191559 ], [ 76.9276236, 13.5413887 ], [ 76.9117093, 13.5631835 ], [ 76.8969002, 13.5613216 ], [ 76.8962871, 13.5642061 ], [ 76.8659343, 13.5627079 ], [ 76.8561517, 13.565338 ], [ 76.8604337, 13.5689461 ], [ 76.8600998, 13.5758197 ], [ 76.8549774, 13.5858207 ], [ 76.8337876, 13.5838461 ], [ 76.8289222, 13.590223 ], [ 76.8027185, 13.5810711 ], [ 76.7533707, 13.5859464 ], [ 76.7244185, 13.5766721 ], [ 76.7077581, 13.5811622 ], [ 76.7072273, 13.5708961 ], [ 76.7125811, 13.5619837 ], [ 76.7135117, 13.5454739 ], [ 76.6972269, 13.536427 ] ] ] }, "properties": { "division_id": "e1fed2f5-db16-43c9-98da-a26039e31f9a", "name": "Gubbi taluk", "normalized_type": "TALUK", "source": "OSM", "source_external_id": "4451597", "source_dataset_version": "osm-snapshot:2026-09-04T20:21:21Z", "source_feature_version": "4", "source_updated_at": "2025-12-16T18:09:53Z", "geometry_version": "d93d31d2-80a1-4d5f-a48c-9ce5fde8264e", "synced_at": "2026-09-28T08:39:29.747Z", "attribution": { "text": "© OpenStreetMap contributors", "license": "ODbL-1.0", "license_url": "https://opendatacommons.org/licenses/odbl/1-0/", "osm_url": "https://www.openstreetmap.org/copyright", "overture_url": "https://docs.overturemaps.org/attribution/" } } } } } }, "304": { "description": "Authorized ETag match, no body. Can count as usage.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "private, max-age=300 (pinned geometry: private, max-age=86400, immutable)" }, "ETag": { "schema": { "type": "string" } } } }, "400": { "description": "Invalid request; correct fields. DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "401": { "description": "Missing/invalid/disabled credentials. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "403": { "description": "Permission denied. AUTH FIX REQUIRED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "404": { "description": "Unknown endpoint/identity/resource. DO NOT RETRY blindly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "405": { "description": "Wrong method. Inspect Allow; DO NOT RETRY unchanged.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Allow": { "schema": { "type": "string" } } } }, "409": { "description": "Ambiguous geometry; review required. Never substitute bbox.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "413": { "description": "Request body/structure or geometry response too large. Reduce/request approved smaller resource.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "429": { "description": "Rate/quota/concurrency denial. Inspect error; Retry-After is present on division429, absent on ordinary mapping429.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } }, "headers": { "Retry-After": { "schema": { "type": "string" }, "example": "60", "description": "Fixed60seconds for rate/quota/concurrency; not a monthly quota reset promise." } } }, "500": { "description": "Unexpected gateway internal failure; no internals exposed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } }, "503": { "description": "Endpoint disabled, circuit open, catalog/state unavailable or operational drain. Bounded retry; never bypass auth.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" } } } } } } } } }