Команда ReQL: polygon

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

r.polygon([lon1, lat1], [lon2, lat2], [lon3, lat3], ...) → polygon
r.polygon(point1, point2, point3, ...) → polygon

Описание

Создаёт геометрический объект типа Polygon. Многоугольник можно задать двумя способами:

• Три или более двумерных массива, задающих широту и долготу вершин многоугольника;
• Три или более объекта Point, задающих вершины многоугольника.

Долгота (−180 до 180) и широта (−90 до 90) вершин нанесены на идеальную сферу. Подробнее о системе координат ReQL см. Поддержка геопространственных данных.

Если последняя точка не задаёт те же координаты, что и первая, polygon закроет многоугольник, соединив их. Нельзя напрямую создать многоугольник с отверстиями, используя polygon, но можно использовать polygonSub, чтобы использовать второй многоугольник внутри первого для определения отверстия.

Пример: Определение многоугольника.

r.table('geo').insert({
    id: 101,
    rectangle: r.polygon(
        [-122.423246,37.779388],
        [-122.423246,37.329898],
        [-121.886420,37.329898],
        [-121.886420,37.779388]
    )
}).run(conn, callback);

Пример: Определение многоугольника, используя массив вершин.

Можно использовать команду args для передачи массива объектов Point (или пар широта-долгота) в polygon.

var vertices = [
    [-122.423246,37.779388],
    [-122.423246,37.329898],
    [-121.886420,37.329898],
    [-121.886420,37.779388]
];
r.table('geo').insert({
    id: 102,
    rectangle: r.polygon(r.args(vertices))
}).run(conn, callback);