{
"openapi": "3.0.3",
"info": {
"title": "Geolocation API",
"description": "Geocode addresses, reverse geocode coordinates, and validate addresses worldwide.",
"version": "1.0"
},
"servers": [
{
"url": "https://api.aikdata.com/v1/geo"
}
],
"paths": {
"/geocode": {
"get": {
"operationId": "getGeocodeAddress",
"summary": "Convert address to coordinates",
"tags": [
"Geocoding"
],
"parameters": [
{
"name": "address",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"example": "1600 Amphitheatre Pkwy, Mountain View, CA"
}
],
"security": [
{
"bearerAuth": []
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"lat": 37.4224764,
"lng": -122.0842499,
"formatted": "1600 Amphitheatre Parkway, Mountain View, CA 94043"
}
}
}
},
"401": {
"description": "Unauthorized"
}
}
}
},
"/reverse": {
"get": {
"operationId": "getReverseGeocode",
"summary": "Convert coordinates to address",
"tags": [
"Geocoding"
],
"parameters": [
{
"name": "lat",
"in": "query",
"required": true,
"schema": {
"type": "number"
},
"example": 37.4224764
},
{
"name": "lng",
"in": "query",
"required": true,
"schema": {
"type": "number"
},
"example": -122.0842499
}
],
"security": [
{
"bearerAuth": []
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"example": {
"formatted": "1600 Amphitheatre Parkway, Mountain View, CA 94043",
"country": "US"
}
}
}
},
"401": {
"description": "Unauthorized"
}
}
}
}
},
"components": {
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
}
}
}
}