Geocoding API

Utility geocoding endpoint for converting supported city, postal code, city_id, or station inputs to coordinates and metadata.

This API accepts a supported location and returns a latitude, and longitude.

Note: This API returns a lat/lon given a supported city, postal code, or station ID. Most populated cities/postal codes are supported. However, this API is not intended to supplant the need for a dedicated geocoding service or provide address level geocoding. If more precise or robust geocoding is required for your application, we recommend using a dedicated geocoding service.

Request Parameters

* One of the following location methods is required: city,ST + country, postal_code + country, city_id or station ID .

Example Requests

Geolocation options: city, postal_code and country, city_id or station ID

city

HTTP Shell Ruby Node.js Python

Copy

https://api.weatherbit.io/v2.0/geocode?key=API_KEY&city=Raleigh%2CNC&country=US

curl -s "https://api.weatherbit.io/v2.0/geocode?key=API_KEY&city=Raleigh%2CNC&country=US"

require 'uri'
require 'net/http'
require 'json'

uri = URI("https://api.weatherbit.io/v2.0/geocode?key=API_KEY&city=Raleigh%2CNC&country=US")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == "https")
request = Net::HTTP::Get.new(uri)
response = http.request(request)
json = JSON.parse(response.body)
puts JSON.pretty_generate(json)

const https = require("https");

https.get("https://api.weatherbit.io/v2.0/geocode?key=API_KEY&city=Raleigh%2CNC&country=US", (res) => {
  let raw = "";
  res.on("data", (chunk) => { raw += chunk; });
  res.on("end", () => {
    const json = JSON.parse(raw);
    console.log(JSON.stringify(json, null, 2));
  });
}).on("error", (err) => {
  console.error(err.message);
});

{
  "country_code": "US",
  "geo_id": "98104-US",
  "lat": 47.6036,
  "lon": -122.3256,
  "name": "King",
  "state_code": "WA",
  "timezone": "America/Los_Angeles"
}

HTTP Statuses

{
  "error": "Some relevant message"
}

{
  "error": "Some relevant message"
}

{
  "error": "Rate limit exceeded.",
  "status_code": 429,
  "status_message": "Rate limit exceeded. Try again later."
}

{
  "error": "Server Error"
}

Return Fields

Returns latitude and longitude for supported city, postal code, station, or city_id inputs. Use this utility endpoint to normalize locations before calling Weatherbit APIs.