> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Geocoding Search

> Resolve place names or postal codes to coordinates, regions, timezone and population.

Search a place name or postal code and resolve it to coordinates and metadata. Narrow results by appending `, <country>` to `name`, filtering with `countryCode`, or capping the result count with `count`. Translated names are available via `language`.

The response contains a `results` array; each entry includes `id`, `name`, `latitude`, `longitude`, `elevation`, `feature_code`, `country`/`country_code`, hierarchical `admin1`–`admin4`, `timezone`, `population` and `postcodes`.

Example: `GET /apis/v1/openmeteo/geocoding?name=Berlin&count=5&language=en`.

**Billing: \$0.00015 per call (150 micros USD), metered per request.** All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa `/apis/*` endpoint); AIsa handles provider access.


## OpenAPI

````yaml openapi/openmeteo.json GET /openmeteo/geocoding
openapi: 3.0.3
info:
  title: Open-Meteo Weather API
  version: 1.0.0
  description: >-
    Open-Meteo weather data routed through the AIsa gateway: forecast,
    historical, air quality, marine, ensemble, seasonal, climate, flood,
    geocoding and elevation. All endpoints are GET pass-through to Open-Meteo
    (open-meteo.com); AIsa handles provider access. Flat pricing of $0.00015 per
    call (150 micros USD), metered per request.
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /openmeteo/geocoding:
    get:
      summary: Geocoding Search
      description: >-
        Search place names or postal codes and resolve them to coordinates,
        administrative regions, country, timezone and population. GET
        pass-through to `https://geocoding-api.open-meteo.com/v1/search`.


        Billed $0.00015 per call, metered per request.
      operationId: get_openmeteo_geocoding
      parameters:
        - name: name
          in: query
          required: true
          description: >-
            Location name or postal code. Append `, <country>` or `, <admin1>`
            to narrow results.
          schema:
            type: string
            example: Berlin
        - name: count
          in: query
          required: false
          description: Maximum number of results (1-100). Default 10.
          schema:
            type: integer
            default: 10
            example: 5
        - name: language
          in: query
          required: false
          description: Two-letter language code for translated names. Default `en`.
          schema:
            type: string
            default: en
            example: en
        - name: countryCode
          in: query
          required: false
          description: ISO-3166-1 alpha-2 country code to filter results.
          schema:
            type: string
            example: DE
        - name: format
          in: query
          required: false
          description: Response format. Default `json`.
          schema:
            type: string
            enum:
              - json
              - protobuf
            default: json
      responses:
        '200':
          description: Matching locations.
          content:
            application/json:
              schema:
                type: object
              example:
                results:
                  - id: 2950159
                    name: Berlin
                    latitude: 52.52437
                    longitude: 13.41053
                    elevation: 74
                    feature_code: PPLC
                    country_code: DE
                    country: Germany
                    country_id: 2921044
                    admin1: Land Berlin
                    timezone: Europe/Berlin
                    population: 3426354
                    postcodes:
                      - '10967'
                      - '13347'
                generationtime_ms: 0.5
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key

````