Команда ReQL: includes

Синтаксис команды

sequence.includes(geometry) → sequence
geometry.includes(geometry) → bool

Описание

Проверяет, полностью ли один геометрический объект содержится в другом. При применении к последовательности геометрических объектов, includes выполняет роль фильтра, возвращая последовательность объектов из последовательности, которые содержат аргумент.

Пример: Содержится ли point2 внутри круга радиусом 2000 метров вокруг point1?

var point1 = r.point(-117.220406,32.719464);
var point2 = r.point(-117.206201,32.725186);
r.circle(point1, 2000).includes(point2).run(conn, callback);
// result returned to callback 
true

Пример: Какие из мест в списке парков содержат circle1?

var circle1 = r.circle([-117.220406,32.719464], 10, {unit: 'mi'});
r.table('parks')('area').includes(circle1).run(conn, callback);

Команда includes не может использовать геопространственный вторичный индекс. Если вы работаете с большими наборами данных, рассмотрите возможность использования индекса и getIntersecting перед includes для сужения начального набора результатов.

Пример: Перепишите предыдущий пример с использованием getIntersecting.

var circle1 = r.circle([-117.220406,32.719464], 10, {unit: 'mi'});
r.table('parks').getIntersecting(circle1, {index: 'area'})('area').
    includes(circle1).run(conn, callback);