Store location search engine

Published June 27, 2022
Selected Clients
carrefour logo

Customers are looking for solutions that maximize their benefits and allow them to meet their needs promptly. A widespread behavior among customers is to check store locations on the store page, which enables them to find a store in the most convenient location. Therefore, it is beneficial to have a solution prepared to satisfy this need.

This use case describes configuring an AI search to return information about a company’s store locations.

Example of store location Search Engine


  • Prepare .CSV file with main information regarding a store location.
    The file should contain required columns - itemId and category and other custom values like postal code, street address, city, and so on.
    You can find the requirements for the .CSV file format here.

    Click to see a sample CSV file

    STORE,Washington,497,38.897,-77.0251,20073,District of Columbia,3960 Killdeer Terrace,Hanson,8,Nienow and Sons
    STORE,Brooklyn,69,40.6924,-73.9666,11205,New York,7720 Mockingbird Circle,Bultman,39231,Baumbach-Glover
    STORE,Los Angeles,742,33.9754,-118.417,90094,California,85774 Stone Corner Street,Washington,652,Grimes LLC
    STORE,Little Rock,197,34.6725,-92.3529,72209,Arkansas,97498 Bunting Road,Boyd,712,Frami Inc
    STORE,Salem,622,44.8685,-123.0438,97306,Oregon,40 Dorton Court,Esch,79,Roberts and Sons
    STORE,Brea,550,33.9187,-117.8892,92822,California,92 Di Loreto Street,Golden Leaf,16877,Hermann-Bergnaum
    STORE,Sacramento,966,38.3774,-121.4444,94207,California,7250 Green Ridge Center,Kensington,6,Jacobson-Cronin
    STORE,Baton Rouge,492,30.3795,-91.1671,70820,Louisiana,3351 Grim Lane,Del Mar,5638,Bahringer Inc
    STORE,Dallas,710,32.7673,-96.7776,75387,Texas,0 Talisman Junction,Glendale,480,"Rippin, Wiza and Borer"


  1. Import .CSV file to a catalog.
  2. Configure AI Engine.
  3. Create and configure search index.

Create a catalog

In the first part of the process, import the .CSV file into the catalog.

Import CSV
Import CSV
  1. Go to Data Management icon Data Management > Catalogs > New Catalog.
    Result: A pop-up opens.
  2. Enter the name of the catalog.
  3. Confirm it by clicking Apply. Result: A catalog appears on the list. Its position on the list is defined by alphabetic order (the list is arranged from Z-A).
  4. Click the catalog on the list.
  5. On the upper right corner, click Import CSV button.
    Result: A pop-up opens.
  6. Click Upload file button.
    Result: A pop-up opens.
  7. Select the file to be uploaded. Confirm with OK.
  8. In the Order key field, type the name of the column whose values are treated as the key.
    In our case, the itemId value will function as the key.
  9. Confirm by clicking Import.
    Result: Imported records are available in the catalog.
Example of a catalog
Example of a catalog

Configure AI Engine

In this part of the process, create and configure feed for AI engine based on the catalog created earlier.

A product feed uploaded to a catalog
A catalog configured for AI engine
  1. Go to Settings > AI engine configuration.
  2. Click Add feed.
    Result: A pop-up appears.
  3. Select the product feed you want to use. In this case select Catalog.
  4. On the pop-up, select the type of catalog: Data catalog.
  5. From the dropdown list, select a catalog created in the previous step.
  6. Confirm by clicking Apply.
  7. On the list of feeds, click the feed created earlier.
  8. In the Applied search engines tab, click Show.
  9. Switch the Search engines toggle on.
  10. Confirm by clicking Apply.
  11. Click Save.
Launching Search Engine
Launching Search Engine

Create an AI Search index

In this part of the process, create an index of AI search that facilitates searching for a store by city, postal code, street address, and street name.

  1. Go to AI Search icon AI Search > Indexes.

  2. Click Add index.
    Result: The index creation screen opens.

  3. In the Index name field, type the meaningful name of the index.

    1. From the Choose catalog dropdown list, select an item catalog to use as the source for the search results.
      WARNING: Remember that the value of an item attribute in the item catalog cannot be longer than 1000 characters. It applies both for creating a new index and updating it.
    2. From the Choose search engine language dropdown, select the language of your search engine.
  4. Click Next step.

    Example of basic index settings
    Example of basic index settings
  5. Define response and searchable attributes.
    More detailed information about these attributes can be found here.
    In this case, city, postal code, street address, and street name are selected a searchable attributes, so the customer will be able to search for stores using them.

  6. Click Next step. Result: The Filters & Facets screen opens.

  7. Skip this step by clicking Next step.
    Result: The Ranking screen opens.

  8. Click Complete.

  9. The Ranking screen opens. Click Complete.

  10. Wait until the index is ready. Refresh the page until you receive information in the upper right corner of the screen that the index is ready.

    Your index is ready
    Your index is ready
  11. Check the results by clicking Preview.

  12. In the search field, enter the name of the store or store location.
    Result: A list with the defined search results appears.

What’s next

Once AI search is configured, it can be implemented in any channel, such for example a website using dynamic content.

Tip: We recommend enriching the integration with a store location map. This can be achieved using public tools such as Azure Maps. You can find extensive documentation for Azure Maps here or use this quick demo application. The .CSV file to be used in this case must contain the longitude and latitude to create the map.

Check the use case set up on the Synerise Demo workspace

You can also check the AI search configuration directly in Synerise Demo workspace.

If you don’t have access to the Synerise Demo workspace, please leave your contact details in this form, and our representative will contact you shortly.

Read more


We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.



Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

Close modal icon Placeholder alt for modal to satisfy link checker