Filters

ElasticBridge includes helpers for common filters, including term, range, and geospatial filters. Use them within a bool context via asBoolean() unless you are composing a raw payload.

Term

HotelRoom::asBoolean()
    ->filterByTerm('code', 'usd')
    ->get();

Range

The valid range operators are gt, gte, lt, and lte.

HotelRoom::asBoolean()
    ->filterByRange('price', 100, 'gte')
    ->filterByRange('price', 500, 'lte')
    ->get();

Alternatively, chain multiple range operators using range():

HotelRoom::asBoolean()
    ->range('price', 'gte', 100)
    ->range('price', 'lte', 500)
    ->get();

Changed in v2

The deprecated from / to range operators were removed — Elasticsearch dropped them from the range query in 7.x. Passing an invalid operator now throws Lacasera\ElasticBridge\Exceptions\InvalidQuery with the list of allowed values, instead of building a query the cluster would reject.

Geo Filters

Geo Bounding Box

HotelRoom::asBoolean()
    ->filterByGeoBoundingBox(
        'hotel.location',
        ['lat' => 10, 'lon' => 10],
        ['lat' => 0, 'lon' => 0]
    )
    ->get();

Geo Distance

HotelRoom::asBoolean()
    ->filterByGeoDistance(
        'hotel.location',
        distance: 5,
        latitude: 40.71,
        longitude: -74.0,
        distanceType: 'arc'
    )
    ->get();

Geo Polygon

HotelRoom::asBoolean()
    ->filterByGeoPolygon('hotel.location', points: [
        ['lat' => 40.73, 'lon' => -74.1],
        ['lat' => 40.01, 'lon' => -71.12],
        ['lat' => 41.12, 'lon' => -71.12],
    ])
    ->get();

Geo Distance Range

HotelRoom::asBoolean()
    ->filterByGeoDistanceRange(
        'hotel.location',
        from: 1,
        to: 5,
        latitude: 40.71,
        longitude: -74.0,
        unit: 'km'
    )
    ->get();

Geo Shape Envelope

HotelRoom::asBoolean()
    ->filterByGeoShape('hotel.location', coordinates: [
        [13.0, 53.0], // top-left
        [14.0, 52.0], // bottom-right
    ])
    ->get();