Read more about this feature on the BOPIS feature page.
With this feature, you can allow your user to search products from across your sites (online) and have it picked up physically from any of your stores nearest to the user (offline).
BOPIS uses the following parameters:
- ll - BOPIS-specific parameter to specify the end-customer's latitude-longitude.
- fl - Returns the distance from the point specified in the ll parameter.
- fq - Allows filtering by distance from the point specified in the ll parameter.
GET https://core.dxpapi.com/api/v1/core/?
account_id=<Bloomreach provided account ID>
&auth_key=jazzhands
&domain_key=example_com
&request_id=8438674518839
&_br_uid_2=uid=7797686432023:v=11.5:ts=1428617911187:hc=55
&ref_url=http://www.example.com/home
&url=http://www.example.com/index.html?q=dresses
&request_type=search
&ll=38.880657,-77.396935 #latitude-longitude of the end customer
&search_type=keyword
&q=dresses
&fl=store_lat_lon, pid #Returns the distance from ll
&fq=store_lat_lon:"100" #Enables filtering by distance from ll
&rows=10
&start=0
Feed requirements
To implement distance-based filtering, your feed must include the store_location attribute. The following table lists the attribute details.
| Attribute | Description | Schema format |
|---|---|---|
| store_location | An array of objects representing geographical locations of stores, each containing latitude and longitude coordinates. Note that this is a reserved attribute. Review the attribute configurations. | store_location=[{"lat":39.786063,"lon":-104.959286}]lat is the latitude coordinate of the store location. Valid values range from -90 to 90 degrees. lon is the longitude coordinate of the store location. Valid values range from -180 to 180 degrees. |
Sample product feed snippet
[
{
"op": "add",
"path": "/products/3478951",
"value": {
"attributes": {
"store_location": [
{
"lat": 39.103858,
"lon": -84.511346
},
{
"lat": 41.500355,
"lon": -81.697647
}
]
}
}
}
]