Core Weather

Geoposition

Endpoint:https://dataservice.accuweather.com

Cities search by geoposition

GET

https://dataservice.accuweather.com

/locations/v1/cities/geoposition/search

Provide a latitude and longitude to retrieve detailed location information.

Cities search by geoposition › query Parameters

qstring · required
A string that indicates the latitude and longitude position.
Example: 40.779,-73.969
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
formatstring
A string value that specifies what type of format to provide the response.
Default: json
topLevelboolean
A boolean value indicating whether or not return only locations with the highest rank. Large cities have higher rank than the neighborhoods within them, so toplevel=true delivers a more generic location result. (Example: 40.73,-74.00 returns Greenwich Village, NY when toplevel=false. If toplevel=true, the same lat/lon pair will return New York, NY.)
Default: false

Cities search by geoposition › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Cities search by geoposition › Responses

PrimaryPostalCodestring · minLength: 1 · required
Official postal code provided by our main location data provider for the requested location
Regionrequired
The object containing the region details
TimeZonerequired
The object containing the timezone details
GeoPositionrequired
The object containing the geoposition details
IsAliasboolean · required
“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location
SupplementalAdminAreasobject[] · required
The object containing a list of administrative area details
DataSetsstring[] · required
Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.
EnglishNamestring · minLength: 1 · required
Location name as displayed in English
Versioninteger · int32 · required
Current version of the API
Keystring · minLength: 1 · required
Unique ID to search a location
Typestring · minLength: 1 · required
Location type such as City, PostalCode, POI or LatLong
Rankinteger · int32 · required
Number applied to locations set by factors such as population, political importance, and geographic size
LocalizedNamestring · minLength: 1 · required
Display name in local dialect set with language code in URL. Default is US English (us-en)
Countryrequired
THe object containing the country details
AdministrativeArearequired
The object containing the amdministrative area details

ParentCity | null
The object containing the parentcity details. This object will be displayed only if the location is part of a larger metropolitan area or parent city.
Details | null
AccuWeather related details about the specific location

Location search by geoposition

GET

https://dataservice.accuweather.com

/locations/v1/geoposition/search

Specify a geoposition point by latitude and longitude to return location data.

Location search by geoposition › query Parameters

qstring · required
A string that indicates the latitude and longitude position.
Example: 40.779,-73.969
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
formatstring
A string value that specifies what type of format to provide the response.
Default: json
topLevelboolean
A boolean value indicating whether or not return only locations with the highest rank. Large cities have higher rank than the neighborhoods within them, so toplevel=true delivers a more generic location result. (Example: 40.73,-74.00 returns Greenwich Village, NY when toplevel=false. If toplevel=true, the same lat/lon pair will return New York, NY.)
Default: false

Location search by geoposition › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Location search by geoposition › Responses

PrimaryPostalCodestring · minLength: 1 · required
Official postal code provided by our main location data provider for the requested location
Regionrequired
The object containing the region details
TimeZonerequired
The object containing the timezone details
GeoPositionrequired
The object containing the geoposition details
IsAliasboolean · required
“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location
SupplementalAdminAreasobject[] · required
The object containing a list of administrative area details
DataSetsstring[] · required
Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.
EnglishNamestring · minLength: 1 · required
Location name as displayed in English
Versioninteger · int32 · required
Current version of the API
Keystring · minLength: 1 · required
Unique ID to search a location
Typestring · minLength: 1 · required
Location type such as City, PostalCode, POI or LatLong
Rankinteger · int32 · required
Number applied to locations set by factors such as population, political importance, and geographic size
LocalizedNamestring · minLength: 1 · required
Display name in local dialect set with language code in URL. Default is US English (us-en)
Countryrequired
THe object containing the country details
AdministrativeArearequired
The object containing the amdministrative area details

ParentCity | null
The object containing the parentcity details. This object will be displayed only if the location is part of a larger metropolitan area or parent city.
Details | null
AccuWeather related details about the specific location

Point of interest by latitude, longitude

GET

https://dataservice.accuweather.com

/locations/v1/poi/geoposition/search

Specify a latitude and longitude coordinate to return location data for a point of interest.

A point of interest (POI) typically refers to a business location, tourist attraction, or other well-known site. Common examples include:

Airports
Stadiums
Parks

Point of interest by latitude, longitude › query Parameters

qstring · required
A string that indicates the latitude and longitude position.
Example: 40.779,-73.969
languagestring
A string that indicates the language in which to return the response. More information can be found here.
Default: en-us
detailsboolean
A boolean value that specifies whether or not to include extended information.
Default: false
formatstring
A string value that specifies what type of format to provide the response.
Default: json
topLevelboolean
A boolean value indicating whether or not return only locations with the highest rank. Large cities have higher rank than the neighborhoods within them, so toplevel=true delivers a more generic location result. (Example: 40.73,-74.00 returns Greenwich Village, NY when toplevel=false. If toplevel=true, the same lat/lon pair will return New York, NY.)
Default: false

Point of interest by latitude, longitude › Headers

Authorizationstring · required
The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Point of interest by latitude, longitude › Responses

PrimaryPostalCodestring · minLength: 1 · required
Official postal code provided by our main location data provider for the requested location
Regionrequired
The object containing the region details
TimeZonerequired
The object containing the timezone details
GeoPositionrequired
The object containing the geoposition details
IsAliasboolean · required
“True” or “false” verification of whether a location is an “alias” or an alternative name or spelling for a requested location
SupplementalAdminAreasobject[] · required
The object containing a list of administrative area details
DataSetsstring[] · required
Array of location-specific products that are available for this location. Products include Alerts, PremiumAirQuality, AirQuality, MinuteCast, and ForecastConfidence. If no location-specific products are available, the array will be empty.
EnglishNamestring · minLength: 1 · required
Location name as displayed in English
Versioninteger · int32 · required
Current version of the API
Keystring · minLength: 1 · required
Unique ID to search a location
Typestring · minLength: 1 · required
Location type such as City, PostalCode, POI or LatLong
Rankinteger · int32 · required
Number applied to locations set by factors such as population, political importance, and geographic size
LocalizedNamestring · minLength: 1 · required
Display name in local dialect set with language code in URL. Default is US English (us-en)
Countryrequired
THe object containing the country details
AdministrativeArearequired
The object containing the amdministrative area details

ParentCity | null
The object containing the parentcity details. This object will be displayed only if the location is part of a larger metropolitan area or parent city.
Details | null
AccuWeather related details about the specific location

Text Search IP Address