Location Service - Point - v3.0

Overview

The Location Service APIs provide the ability to lookup a location name or geocode (latitude and longitude) to retrieve a set of locations matching the request.

The Location Point API provides detailed location data for a specific point on the globe, searchable by: Geocode (Latitude and Longitude), Postal Key (postal code:country code composite), IATA Code, ICAO Code, Place ID (encrypted location identifier), Canonical City ID (city level feature identifier), and Location ID (legacy location identifier).

The Location Point API is most commonly used for GPS-based location searches where a pair of coordinates or known location codes are queried to identify location features and related metadata.

HTTP Headers and Data Lifetime — Caching and Expiration

For details on appropriate header values as well as caching and expiration definitions, see the Weather Company Data API Common Usage Guide.

URL Construction

https://api.weather.com/v3/location/point?geocode=33.74,-84.39&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/location/point?postalKey=30339:US&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/location/point?iataCode=ATL&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/location/point?icaoCode=KATL&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/location/point?placeid=ee0214ae7fb1d265f3e4d2509e77557119b2cac9d0ac1013b593c74a1567f2b7&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/location/point?canonicalCityId=3e933388e3fb38c28c2d0806165bf7e3185d84bbb370417734798573ee243240&language=en-US&format=json&apiKey=yourApiKey

https://api.weather.com/v3/location/point?locid=USWY0183:1:US&language=en-US&format=json&apiKey=yourApiKey

Optional Query Parameters

Location Types

Data Elements & Definitions

Field names are sorted alphabetically for presentation. This does not represent the sort order of the API response.

JSON Sample

{
  "location": {
    "latitude": 29.162,
    "longitude": -81.525,
    "city": "Astor",
    "locale": {
      "locale1": "Lake County",
      "locale2": "Astor",
      "locale3": "Manhatten",
      "locale4": null
    },
    "neighborhood": null,
    "adminDistrict": "Florida",
    "adminDistrictCode": "FL",
    "postalCode": "32102",
    "postalKey": "32102:US",
    "country": "United States",
    "countryCode": "US",
    "ianaTimeZone": "America/New_York",
    "displayName": "Manhatten",
    "displayContext": "Astor, United States",
    "dstEnd": "2023-11-05T01:00:00-0500",
    "dstStart": "2024-03-10T03:00:00-0400",
    "dmaCd": "534",
    "placeId": "4911fe91dedcc116bd7ebc5258a098b6bc68bca2b81c326ca329d7965af519bf",
    "disputedArea": false,
    "disputedCountries": null,
    "disputedCountryCodes": null,
    "disputedCustomers": null,
    "disputedShowCountry": [false],
    "canonicalCityId": "d76c26f1eef1099f8fa128c897644e4a158172913748c815d44f660548883aa5",
    "countyId": "FLC069",
    "locId": "USFL0018:1:US",
    "locationCategory": null,
    "pollenId": null,
    "pwsId": "KFLASTOR16",
    "regionalSatellite": "se",
    "tideId": "8720832",
    "type": "postal",
    "zoneId": "FLZ044"
  }
}