Open-Meteo Geocoding

How to Use This API

1. Search for a City

Search for "Los Angeles" and return the best match:

https://geocoding-api.open-meteo.com/v1/search?name=Los+Angeles&count=1

Parameters: name is the city name (URL-encoded). count limits results (default 10, max 100). language can be set to en, de, fr, etc. for localized results.

2. Get Multiple Results for Ambiguous Names

There are 30+ "Springfield" locations worldwide — get them all:

https://geocoding-api.open-meteo.com/v1/search?name=Springfield&count=10&language=en

Each result includes country, admin1 (state/province), country_code, latitude, longitude, elevation, and timezone — enough to disambiguate.

3. JavaScript — Geocode + Weather in One Flow

async function getWeatherForCity(city) {
  const geo = await fetch(
    'https://geocoding-api.open-meteo.com/v1/search?name=' +
    encodeURIComponent(city) + '&count=1'
  ).then(r => r.json());
  
  const loc = geo.results[0];
  const weather = await fetch(
    'https://api.open-meteo.com/v1/forecast?latitude=' +
    loc.latitude + '&longitude=' + loc.longitude +
    '¤t=temperature_2m,wind_speed_10m'
  ).then(r => r.json());
  
  console.log(loc.name + ', ' + loc.country + ': ' +
    weather.current.temperature_2m + '°C');
}

getWeatherForCity('Tokyo');

4. Python — Find Cities and Their Coordinates

import requests

resp = requests.get(
    'https://geocoding-api.open-meteo.com/v1/search',
    params={'name': 'Paris', 'count': 5, 'language': 'en'}
)
data = resp.json()

for r in data['results']:
    print(f"{r['name']}, {r.get('admin1', '')}, {r['country']} "
          f"→ {r['latitude']}, {r['longitude']} "
          f"({r['elevation']}m, tz: {r['timezone']})")