jAttention!
This resource retrieves a list of stores, for the given site, that are within a configured distance of a location on the earth. The stores and their distance from the specified location are returned as a result set of Store objects. The distance is interpreted either in miles or kilometers depending on the distance_unit input parameter.
The location can be specified by either directly providing a latitude/longitude coordinate pair or by providing a country and a postal code:
- If a postal code is passed, the resource looks in the system's geolocation mappings to find the coordinates for this postal code. If no matching geolocation is found, the resource will return an empty list of stores.
- If coordinates are passed, the values for country and postal code are ignored.
This endpoint may return the following faults:
- 400 - MalformedDistanceUnitException - Invalid distance_unit given.
- 400 - MissingCoordinatesException - Thrown if only one of latitude or longitude are provided.
- 400 - MissingCountryCodeException - Thrown if no coordinates (latitude and longitude) are provided and in addition no country code is given.
- 400 - MissingPostalCodeException - Thrown if no coordinates (latitude and longitude) are provided and in addition no postal code is given..
curl "https://{host}/s/{siteId}/dw/shop/v25_6/stores"The maximum number of instances per request. Default value is 25.
The geo coordinate latitude to search for stores (value range -90.00 .. 90.00).
The geo coordinate longitude to search for stores (value range -180.00 .. 180.00).
The two letter ISO country code e.g. "US".
The area (radius) in distancUnit where stores will be searched for (default is half of the earth's perimeter).
The postal code e.g. "01801".
The distance unit. Supported values are "mi" and "km" (for miles and kilometers respectively, default is "km").
The result set index to return the first instance for. Default value is 0.
MalformedDistanceUnitException - Invalid distance_unit given. or MissingCoordinatesException - Thrown if only one of latitude or longitude are provided. or MissingCountryCodeException - Thrown if no coordinates (latitude and longitude) are provided and in addition no country code is given. or MissingPostalCodeException - Thrown if no coordinates (latitude and longitude) are provided and in addition no postal code is given..
{
"arguments": {},
"cause": {
"cause": "",
"message": "",
"type": ""
},
"display_message_pattern": "",
"message": "",
"stack_trace": "",
"type": ""
}
A map that provides fault arguments.
Data can be used to provide error messages on the client side.
The localized display message pattern, if the request parameter display_locale was given
The message text of the java exception.
The name of the java exception.