Команда ReQL: polygon

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

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

Описание

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

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

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

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

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

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)

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

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

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)