Команда ReQL: circle

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

r.circle([longitude, latitude], radius[, num_vertices=32, geo_system='WGS84', unit='m', fill=True]) → geometry
r.circle(point, radius[, {num_vertices=32, geo_system='WGS84', unit='m', fill=True]) → geometry

Описание

Создаёт круговую линию или многоугольник. Круг в RethinkDB — это многоугольник или линия, приближённо представляющая окружность заданного радиуса вокруг заданного центра, состоящая из указанного количества вершин (по умолчанию 32).

Центр может быть задан двумя числами с плавающей точкой: широтой (−90 до 90) и долготой (−180 до 180) точки на идеальной сфере (см. Поддержку геопространственных данных для получения дополнительной информации о системе координат ReQL), или объектом точки. Радиус — это число с плавающей точкой, по умолчанию измеряемое в метрах, но это можно изменить с помощью аргумента unit.

Доступны необязательные аргументы с circle:

• num_vertices: количество вершин в многоугольнике или линии. По умолчанию 32.
• geo_system: эллипсоид отсчёта, который используется для географических координат. Возможные значения: WGS84 (по умолчанию), стандартный для геометрии Земли, или unit_sphere, идеальная сфера радиусом 1 метр.
• unit: единица измерения расстояния радиуса. Возможные значения: m (метр, по умолчанию), km (километр), mi (миля), nm (морская миля), ft (фут).
• fill: если True (по умолчанию), круг заполняется, создавая многоугольник; если False, круг не заполняется (создаётся линия).

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

r.table('geo').insert({
    'id': 300,
    'name': 'Hayes Valley',
    'neighborhood': r.circle([-122.423246, 37.779388], 1000)
}).run(conn)