Skip to main content

​
Location Filter

The location field lets you narrow search results by geographic area. It supports up to four levels of precision, from broad to specific:
  1. Continent (e.g. North America, Europe)
  2. Country (in English)
  3. State / Region (in the country’s local language)
  4. Sub-region (when applicable, in the country’s local language)
  5. City (in the country’s local language)
You can use any of these levels. You do not need to provide all of them.Examples of valid values:
  • North America
  • United States
  • California
  • San Francisco
  • San Francisco, California, United States
We strongly recommend trying the filter in the UI first. It gives you a concrete feel for what values exist and how they are interpreted by the system.

​
How granularity works

The goal of the location system is to let you “zoom” your search, from very broad to very precise. Each level represents a different zoning depth.Take two concrete cases:

​
San Francisco (US)

Typical levels:
  • Country: United States
  • State / Region: California
  • City: San Francisco
Here, there is no meaningful sub-region between the state and the city. You move directly from California to San Francisco.You can therefore search at different depths:
  • United States → everything in the US
  • California → everything in California
  • San Francisco → only San Francisco
Each step narrows the scope.

​
Brest (France)

Typical levels:
  • Country: France
  • Region: Bretagne
  • Sub-region: Finistère
  • City: Brest
This adds an extra layer between region and city. You can now search at four different depths:
  • France → everything in France
  • Bretagne → everything in the Brittany region
  • Finistère → everything in that department
  • Brest → only the city of Brest
The concept is the same in both cases: each level represents a finer geographic boundary. Some countries have more intermediate layers than others, but the mental model is always “zooming in” on the map.