Skip to main content
Store Finder helps customers find your nearest locations by combining geocoding, distance calculations, and interactive mapping.

​
Documentation

Get started with Store Finder using the resources below:

Quick Start Guide

Complete guide to building a Store Finder

Store Finder APIs

See all Store Finder API documentation

​
FAQ

Store Finder combines multiple APIs in sequence:
  1. Store your locations using Location Management APIs or the account UI
  2. Capture customer location and convert to coordinates using Geocoding
  3. Calculate distances between customer and stores using Distance Finder
  4. Display results on an interactive map using Mapping API
See the Quick Start Guide for detailed workflow information.
Store Finder requires two types of API keys, both generated automatically when creating a Store Finder service:
  • Service key - For public-facing operations (Geocoding, Distance Finder, Mapping). Use this in client-side code.
  • Management key - For private operations (creating/editing/deleting location lists). Keep this secure and use only server-side.
See the Quick Start Guide for setup instructions.
Three options are available:
  • Upload CSV files via the account UI (best for infrequent updates)
  • Use the Create List API for programmatic management (best for frequent updates)
  • Host locations yourself and pass coordinates directly to Distance Finder
See the Quick Start Guide for detailed instructions on creating and managing lists.
Road-based distances provide more accurate, realistic travel information than straight-line calculations. Straight-line distances ignore geographic features like bodies of water or non-traversable terrain, potentially directing customers to stores that appear close but are difficult to reach.Travel times calculated from historical traffic data help customers quickly assess accessibility.
  • MaxDistance: Smaller search radius improves performance (default 100km, max 500km)
  • MaxResults: Fewer results improve performance (default 10, max 100)
  • Number of locations: Linear correlation between location count and response time
  • Multiple lists: Splitting stores into regional lists improves performance
See the Quick Start Guide for more performance tips.
Yes. Distance calculations work globally and between countries within the same region (e.g., France to Germany within Europe). When crossing bodies of water, ferry transport is considered where data is available.