Geocoding API

curl --request POST \
  --url https://api.aisa.one/apis/v1/google-maps/geocoding-api \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "YOUR_API_KEY",
  "bounds": "34.172684,-118.604794|34.236144,-118.500938",
  "latlng": "40.714224,-73.961452",
  "region": "US",
  "address": "1600 Amphitheatre Parkway, Mountain View, CA",
  "language": "en",
  "place_id": "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
  "components": "postal_code:94043|country:US",
  "result_type": "street_address|locality",
  "location_type": "ROOFTOP|RANGE_INTERPOLATED",
  "extra_computations": [
    "ADDRESS_DESCRIPTORS"
  ]
}
'

import requests

url = "https://api.aisa.one/apis/v1/google-maps/geocoding-api"

payload = {
    "key": "YOUR_API_KEY",
    "bounds": "34.172684,-118.604794|34.236144,-118.500938",
    "latlng": "40.714224,-73.961452",
    "region": "US",
    "address": "1600 Amphitheatre Parkway, Mountain View, CA",
    "language": "en",
    "place_id": "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
    "components": "postal_code:94043|country:US",
    "result_type": "street_address|locality",
    "location_type": "ROOFTOP|RANGE_INTERPOLATED",
    "extra_computations": ["ADDRESS_DESCRIPTORS"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: 'YOUR_API_KEY',
    bounds: '34.172684,-118.604794|34.236144,-118.500938',
    latlng: '40.714224,-73.961452',
    region: 'US',
    address: '1600 Amphitheatre Parkway, Mountain View, CA',
    language: 'en',
    place_id: 'ChIJd8BlQ2BZwokRAFUEcm_qrcA',
    components: 'postal_code:94043|country:US',
    result_type: 'street_address|locality',
    location_type: 'ROOFTOP|RANGE_INTERPOLATED',
    extra_computations: ['ADDRESS_DESCRIPTORS']
  })
};

fetch('https://api.aisa.one/apis/v1/google-maps/geocoding-api', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/google-maps/geocoding-api",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'key' => 'YOUR_API_KEY',
    'bounds' => '34.172684,-118.604794|34.236144,-118.500938',
    'latlng' => '40.714224,-73.961452',
    'region' => 'US',
    'address' => '1600 Amphitheatre Parkway, Mountain View, CA',
    'language' => 'en',
    'place_id' => 'ChIJd8BlQ2BZwokRAFUEcm_qrcA',
    'components' => 'postal_code:94043|country:US',
    'result_type' => 'street_address|locality',
    'location_type' => 'ROOFTOP|RANGE_INTERPOLATED',
    'extra_computations' => [
        'ADDRESS_DESCRIPTORS'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/google-maps/geocoding-api"

	payload := strings.NewReader("{\n  \"key\": \"YOUR_API_KEY\",\n  \"bounds\": \"34.172684,-118.604794|34.236144,-118.500938\",\n  \"latlng\": \"40.714224,-73.961452\",\n  \"region\": \"US\",\n  \"address\": \"1600 Amphitheatre Parkway, Mountain View, CA\",\n  \"language\": \"en\",\n  \"place_id\": \"ChIJd8BlQ2BZwokRAFUEcm_qrcA\",\n  \"components\": \"postal_code:94043|country:US\",\n  \"result_type\": \"street_address|locality\",\n  \"location_type\": \"ROOFTOP|RANGE_INTERPOLATED\",\n  \"extra_computations\": [\n    \"ADDRESS_DESCRIPTORS\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/google-maps/geocoding-api")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"YOUR_API_KEY\",\n  \"bounds\": \"34.172684,-118.604794|34.236144,-118.500938\",\n  \"latlng\": \"40.714224,-73.961452\",\n  \"region\": \"US\",\n  \"address\": \"1600 Amphitheatre Parkway, Mountain View, CA\",\n  \"language\": \"en\",\n  \"place_id\": \"ChIJd8BlQ2BZwokRAFUEcm_qrcA\",\n  \"components\": \"postal_code:94043|country:US\",\n  \"result_type\": \"street_address|locality\",\n  \"location_type\": \"ROOFTOP|RANGE_INTERPOLATED\",\n  \"extra_computations\": [\n    \"ADDRESS_DESCRIPTORS\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/google-maps/geocoding-api")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"YOUR_API_KEY\",\n  \"bounds\": \"34.172684,-118.604794|34.236144,-118.500938\",\n  \"latlng\": \"40.714224,-73.961452\",\n  \"region\": \"US\",\n  \"address\": \"1600 Amphitheatre Parkway, Mountain View, CA\",\n  \"language\": \"en\",\n  \"place_id\": \"ChIJd8BlQ2BZwokRAFUEcm_qrcA\",\n  \"components\": \"postal_code:94043|country:US\",\n  \"result_type\": \"street_address|locality\",\n  \"location_type\": \"ROOFTOP|RANGE_INTERPOLATED\",\n  \"extra_computations\": [\n    \"ADDRESS_DESCRIPTORS\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "results": [
    {
      "types": [
        "<string>"
      ],
      "geometry": {
        "location": {
          "lat": 123,
          "lng": 123
        },
        "viewport": {
          "northeast": {
            "lat": 123,
            "lng": 123
          },
          "southwest": {
            "lat": 123,
            "lng": 123
          }
        },
        "location_type": "<string>",
        "bounds": {
          "northeast": {
            "lat": 123,
            "lng": 123
          },
          "southwest": {
            "lat": 123,
            "lng": 123
          }
        }
      },
      "place_id": "<string>",
      "formatted_address": "<string>",
      "address_components": [
        {
          "types": [
            "<string>"
          ],
          "long_name": "<string>",
          "short_name": "<string>"
        }
      ],
      "plus_code": {
        "global_code": "<string>",
        "compound_code": "<string>"
      },
      "partial_match": true,
      "postcode_localities": [
        "<string>"
      ]
    }
  ],
  "plus_code": {
    "global_code": "<string>",
    "compound_code": "<string>"
  },
  "error_message": "<string>"
}

POST

https://api.aisa.one

apis

google-maps

geocoding-api

Geocoding API

curl --request POST \
  --url https://api.aisa.one/apis/v1/google-maps/geocoding-api \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "YOUR_API_KEY",
  "bounds": "34.172684,-118.604794|34.236144,-118.500938",
  "latlng": "40.714224,-73.961452",
  "region": "US",
  "address": "1600 Amphitheatre Parkway, Mountain View, CA",
  "language": "en",
  "place_id": "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
  "components": "postal_code:94043|country:US",
  "result_type": "street_address|locality",
  "location_type": "ROOFTOP|RANGE_INTERPOLATED",
  "extra_computations": [
    "ADDRESS_DESCRIPTORS"
  ]
}
'

import requests

url = "https://api.aisa.one/apis/v1/google-maps/geocoding-api"

payload = {
    "key": "YOUR_API_KEY",
    "bounds": "34.172684,-118.604794|34.236144,-118.500938",
    "latlng": "40.714224,-73.961452",
    "region": "US",
    "address": "1600 Amphitheatre Parkway, Mountain View, CA",
    "language": "en",
    "place_id": "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
    "components": "postal_code:94043|country:US",
    "result_type": "street_address|locality",
    "location_type": "ROOFTOP|RANGE_INTERPOLATED",
    "extra_computations": ["ADDRESS_DESCRIPTORS"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: 'YOUR_API_KEY',
    bounds: '34.172684,-118.604794|34.236144,-118.500938',
    latlng: '40.714224,-73.961452',
    region: 'US',
    address: '1600 Amphitheatre Parkway, Mountain View, CA',
    language: 'en',
    place_id: 'ChIJd8BlQ2BZwokRAFUEcm_qrcA',
    components: 'postal_code:94043|country:US',
    result_type: 'street_address|locality',
    location_type: 'ROOFTOP|RANGE_INTERPOLATED',
    extra_computations: ['ADDRESS_DESCRIPTORS']
  })
};

fetch('https://api.aisa.one/apis/v1/google-maps/geocoding-api', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/google-maps/geocoding-api",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'key' => 'YOUR_API_KEY',
    'bounds' => '34.172684,-118.604794|34.236144,-118.500938',
    'latlng' => '40.714224,-73.961452',
    'region' => 'US',
    'address' => '1600 Amphitheatre Parkway, Mountain View, CA',
    'language' => 'en',
    'place_id' => 'ChIJd8BlQ2BZwokRAFUEcm_qrcA',
    'components' => 'postal_code:94043|country:US',
    'result_type' => 'street_address|locality',
    'location_type' => 'ROOFTOP|RANGE_INTERPOLATED',
    'extra_computations' => [
        'ADDRESS_DESCRIPTORS'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/google-maps/geocoding-api"

	payload := strings.NewReader("{\n  \"key\": \"YOUR_API_KEY\",\n  \"bounds\": \"34.172684,-118.604794|34.236144,-118.500938\",\n  \"latlng\": \"40.714224,-73.961452\",\n  \"region\": \"US\",\n  \"address\": \"1600 Amphitheatre Parkway, Mountain View, CA\",\n  \"language\": \"en\",\n  \"place_id\": \"ChIJd8BlQ2BZwokRAFUEcm_qrcA\",\n  \"components\": \"postal_code:94043|country:US\",\n  \"result_type\": \"street_address|locality\",\n  \"location_type\": \"ROOFTOP|RANGE_INTERPOLATED\",\n  \"extra_computations\": [\n    \"ADDRESS_DESCRIPTORS\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/google-maps/geocoding-api")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"YOUR_API_KEY\",\n  \"bounds\": \"34.172684,-118.604794|34.236144,-118.500938\",\n  \"latlng\": \"40.714224,-73.961452\",\n  \"region\": \"US\",\n  \"address\": \"1600 Amphitheatre Parkway, Mountain View, CA\",\n  \"language\": \"en\",\n  \"place_id\": \"ChIJd8BlQ2BZwokRAFUEcm_qrcA\",\n  \"components\": \"postal_code:94043|country:US\",\n  \"result_type\": \"street_address|locality\",\n  \"location_type\": \"ROOFTOP|RANGE_INTERPOLATED\",\n  \"extra_computations\": [\n    \"ADDRESS_DESCRIPTORS\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/google-maps/geocoding-api")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"YOUR_API_KEY\",\n  \"bounds\": \"34.172684,-118.604794|34.236144,-118.500938\",\n  \"latlng\": \"40.714224,-73.961452\",\n  \"region\": \"US\",\n  \"address\": \"1600 Amphitheatre Parkway, Mountain View, CA\",\n  \"language\": \"en\",\n  \"place_id\": \"ChIJd8BlQ2BZwokRAFUEcm_qrcA\",\n  \"components\": \"postal_code:94043|country:US\",\n  \"result_type\": \"street_address|locality\",\n  \"location_type\": \"ROOFTOP|RANGE_INTERPOLATED\",\n  \"extra_computations\": [\n    \"ADDRESS_DESCRIPTORS\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "results": [
    {
      "types": [
        "<string>"
      ],
      "geometry": {
        "location": {
          "lat": 123,
          "lng": 123
        },
        "viewport": {
          "northeast": {
            "lat": 123,
            "lng": 123
          },
          "southwest": {
            "lat": 123,
            "lng": 123
          }
        },
        "location_type": "<string>",
        "bounds": {
          "northeast": {
            "lat": 123,
            "lng": 123
          },
          "southwest": {
            "lat": 123,
            "lng": 123
          }
        }
      },
      "place_id": "<string>",
      "formatted_address": "<string>",
      "address_components": [
        {
          "types": [
            "<string>"
          ],
          "long_name": "<string>",
          "short_name": "<string>"
        }
      ],
      "plus_code": {
        "global_code": "<string>",
        "compound_code": "<string>"
      },
      "partial_match": true,
      "postcode_localities": [
        "<string>"
      ]
    }
  ],
  "plus_code": {
    "global_code": "<string>",
    "compound_code": "<string>"
  },
  "error_message": "<string>"
}

Request contract

Method and path: POST /apis/v1/google-maps/geocoding-api
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/google-maps/geocoding-api
Runtime facts: 3b5a2acec503471a11eb19f2556b4dd51989d71bc63d22f67f55218e55b002ef

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "google-maps.geocoding-api",
  "method": "POST",
  "path": "/apis/v1/google-maps/geocoding-api",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": false,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "key": {
              "type": "string",
              "examples": [
                "YOUR_API_KEY"
              ],
              "description": "Your application's API key. If not provided, will be extracted from connection metadata."
            },
            "bounds": {
              "type": "string",
              "examples": [
                "34.172684,-118.604794|34.236144,-118.500938"
              ],
              "description": "The bounding box of the viewport within which to bias geocode results more prominently (e.g., '34.172684,-118.604794|34.236144,-118.500938'). This parameter will only influence, not fully restrict, results."
            },
            "latlng": {
              "type": "string",
              "examples": [
                "40.714224,-73.961452"
              ],
              "description": "The latitude and longitude coordinates specifying the location for which you want the closest, human-readable address (e.g., '40.714224,-73.961452'). Provide for reverse geocoding."
            },
            "region": {
              "type": "string",
              "examples": [
                "US",
                "ES"
              ],
              "description": "The region code, specified as a ccTLD ('top-level domain') two-character value. This parameter will only influence, not fully restrict, results from the geocoder."
            },
            "address": {
              "type": "string",
              "examples": [
                "1600 Amphitheatre Parkway, Mountain View, CA"
              ],
              "description": "The street address or plus code that you want to geocode. Provide for geocoding (address to coordinates)."
            },
            "language": {
              "type": "string",
              "examples": [
                "en",
                "es"
              ],
              "description": "The language in which to return results. If language is not supplied, the geocoder attempts to use the preferred language as specified in the Accept-Language header, or the native language of the domain from which the request is sent."
            },
            "place_id": {
              "type": "string",
              "examples": [
                "ChIJd8BlQ2BZwokRAFUEcm_qrcA"
              ],
              "description": "The place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding."
            },
            "components": {
              "type": "string",
              "examples": [
                "postal_code:94043|country:US"
              ],
              "description": "A components filter with elements separated by a pipe (|). E.g., 'postal_code:94043|country:US'. Used for geocoding, can be restrictive or biasing. Supplying only `components` without `address` may return ZERO_RESULTS for some queries."
            },
            "result_type": {
              "type": "string",
              "examples": [
                "street_address|locality"
              ],
              "description": "A filter of one or more address types, separated by a pipe (|) (e.g., 'street_address|locality'). Used for reverse geocoding and place ID geocoding."
            },
            "location_type": {
              "type": "string",
              "examples": [
                "ROOFTOP|RANGE_INTERPOLATED"
              ],
              "description": "A filter of one or more location types, separated by a pipe (|) (e.g., 'ROOFTOP|RANGE_INTERPOLATED'). Used for reverse geocoding and place ID geocoding."
            },
            "extra_computations": {
              "type": "array",
              "items": {
                "enum": [
                  "ADDRESS_DESCRIPTORS",
                  "BUILDING_AND_ENTRANCES"
                ],
                "type": "string"
              },
              "examples": [
                [
                  "ADDRESS_DESCRIPTORS"
                ]
              ],
              "description": "Use this parameter to specify additional features in the response. Can select multiple values."
            }
          }
        }
      }
    }
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "response_units",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.0053,
    "estimate_source": "profile_seed",
    "evidence_source": "response_body",
    "maximum_units": 10000000,
    "unit": "provider_credit",
    "unit_rate_usd": 1e-06
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Usage-based billing; Default request estimate: $0.0053 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.0053
Declared unit rate (USD): 1e-06
Billing unit: provider_credit
Cost contract: response_units
Published reference multiplier: 1.0
Declared maximum count/units: 10000000
Settlement evidence source: response_body

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

key

string

Your application's API key. If not provided, will be extracted from connection metadata.

Example:

"YOUR_API_KEY"

bounds

string

The bounding box of the viewport within which to bias geocode results more prominently (e.g., '34.172684,-118.604794|34.236144,-118.500938'). This parameter will only influence, not fully restrict, results.

Example:

"34.172684,-118.604794|34.236144,-118.500938"

latlng

string

The latitude and longitude coordinates specifying the location for which you want the closest, human-readable address (e.g., '40.714224,-73.961452'). Provide for reverse geocoding.

Example:

"40.714224,-73.961452"

region

string

The region code, specified as a ccTLD ('top-level domain') two-character value. This parameter will only influence, not fully restrict, results from the geocoder.

Examples:

"US"

"ES"

address

string

The street address or plus code that you want to geocode. Provide for geocoding (address to coordinates).

Example:

"1600 Amphitheatre Parkway, Mountain View, CA"

language

string

The language in which to return results. If language is not supplied, the geocoder attempts to use the preferred language as specified in the Accept-Language header, or the native language of the domain from which the request is sent.

Examples:

"en"

"es"

place_id

string

The place ID of the place for which you wish to obtain the human-readable address. Provide for place ID geocoding.

Example:

"ChIJd8BlQ2BZwokRAFUEcm_qrcA"

components

string

A components filter with elements separated by a pipe (|). E.g., 'postal_code:94043|country:US'. Used for geocoding, can be restrictive or biasing. Supplying only components without address may return ZERO_RESULTS for some queries.

Example:

"postal_code:94043|country:US"

result_type

string

A filter of one or more address types, separated by a pipe (|) (e.g., 'street_address|locality'). Used for reverse geocoding and place ID geocoding.

Example:

"street_address|locality"

location_type

string

A filter of one or more location types, separated by a pipe (|) (e.g., 'ROOFTOP|RANGE_INTERPOLATED'). Used for reverse geocoding and place ID geocoding.

Example:

"ROOFTOP|RANGE_INTERPOLATED"

extra_computations

enum<string>[]

Use this parameter to specify additional features in the response. Can select multiple values.

Available options:

ADDRESS_DESCRIPTORS,

BUILDING_AND_ENTRANCES

Example:

["ADDRESS_DESCRIPTORS"]

Response

Tool result data

status

string

required

results

object[]

required

Show child attributes

plus_code

object

Show child attributes

error_message

string