Filter by geo polygon

The _geoPolygon filter returns documents located within a custom polygon shape. Use this for irregular geographic boundaries like delivery zones, school districts, or custom sales territories that cannot be represented by a simple circle or rectangle.

Syntax

_geoPolygon([lat1, lng1], [lat2, lng2], [lat3, lng3], ...)

Parameter	Type	Description
`[lat, lng]`	Float pair	A vertex of the polygon

You must provide at least 3 coordinate pairs to define a valid polygon. Meilisearch automatically closes the polygon by connecting the last point back to the first, so you do not need to repeat the starting coordinate.

Filter by polygon

The following example defines a triangular delivery zone in central Milan and searches for restaurants within it:

curl \
  -X POST 'MEILISEARCH_URL/indexes/restaurants/search' \
  -H 'Content-type:application/json' \
  --data-binary '{
    "filter": "_geoPolygon([45.490, 9.170], [45.490, 9.210], [45.450, 9.190])"
  }'

This creates a triangle with vertices at:

Northwest corner: 45.490, 9.170
Northeast corner: 45.490, 9.210
South center: 45.450, 9.190

Meilisearch returns all documents located within this triangular area:

{
  "hits": [
    {
      "id": 1,
      "name": "Nàpiz' Milano",
      "address": "Viale Vittorio Veneto, 30, 20124, Milan, Italy",
      "type": "pizza",
      "rating": 9,
      "_geo": {
        "lat": 45.4777599,
        "lng": 9.1967508
      },
      "_geoDistance": 0
    },
    {
      "id": 3,
      "name": "Artico Gelateria Tradizionale",
      "address": "Via Dogana, 1, 20123 Milan, Italy",
      "type": "ice cream",
      "rating": 10,
      "_geo": {
        "lat": 45.4632046,
        "lng": 9.1719421
      },
      "_geoDistance": 0
    }
  ]
}

Define complex shapes

You can use as many points as needed to define complex boundaries. For example, a five-sided delivery zone:

curl \
  -X POST 'MEILISEARCH_URL/indexes/restaurants/search' \
  -H 'Content-type:application/json' \
  --data-binary '{
    "filter": "_geoPolygon([45.495, 9.175], [45.495, 9.205], [45.475, 9.215], [45.450, 9.195], [45.460, 9.165])"
  }'

Meilisearch does not support polygons that cross the 180th meridian (transmeridian shapes). If your polygon crosses this line, split it into two separate polygons and query each one individually.

Combine with other filters

You can combine _geoPolygon with any other filter using AND and OR operators:

curl \
  -X POST 'MEILISEARCH_URL/indexes/restaurants/search' \
  -H 'Content-type:application/json' \
  --data-binary '{
    "filter": "_geoPolygon([45.490, 9.170], [45.490, 9.210], [45.450, 9.190]) AND type = pizza"
  }'

You can also combine _geoPolygon with _geoRadius or _geoBoundingBox for more precise geographic targeting:

curl \
  -X POST 'MEILISEARCH_URL/indexes/restaurants/search' \
  -H 'Content-type:application/json' \
  --data-binary '{
    "filter": "_geoPolygon([45.490, 9.170], [45.490, 9.210], [45.450, 9.190]) AND _geoRadius(45.472735, 9.184019, 1000)"
  }'

Geo search overview

Learn about all geo search capabilities in Meilisearch.

Search API reference

Full reference for the search endpoint and filter parameter.

Capabilities

Full-text search

Hybrid and semantic search

Geo search

Conversational search

Multi-search

Filtering, sorting, and faceting

Personalization

Analytics

Security and tenant tokens

Search rules

Platform

Indexing

Syntax

Filter by polygon

Define complex shapes

Combine with other filters

Geo search overview

Search API reference

​Syntax

​Filter by polygon

​Define complex shapes

​Combine with other filters

Geo search overview

Search API reference

Syntax

Filter by polygon

Define complex shapes

Combine with other filters