<<< предыдущая глава | оглавление | следующая глава >>>
Удаляет таблицу и все связанные с ней столбцы геометрии. Замечание: если установленный pgsql поддерживает схемы, когда схема не предоставлена, используется current_schema().
Обновляет SRID всех объектов в столбце геометрии, обновляет ограничения и ссылки в этом столбце. Замечание: если установленный pgsql поддерживает схемы, когда схема не предоставлена, используется current_schema().
Обновляет статистику пространственных таблиц для использования планировщиком запросов. Кроме того, вам понадобится "VACUUM ANALYZE [table_name] [column_name]" для завершения процесса сбора статистики. Замечание: начиная с PostgreSQL 8.0 сбор статистики автоматически выполняется при запуске "VACUUM ANALYZE".
Возвращает версию PostGIS и опции, с которыми он был скомпилирован.
До версии 1.1.0 это была процедурная функция, возможно, возвращающая неправильную информацию (в случае неполного апгрейда базы данных).
Возвращает номер версии библиотеки PostGIS.
Присутствует с 0.9.0
Возвращает дату сборки библиотеки PostGIS.
Присутствует с 1.0.0RC1
Возвращает дату создания скриптов PostGIS.
Присутствует с 1.0.0RC1.
Возвращает версию скриптов PostGIS, установленных в базе данных.
Если вывод этой функции не совпадает с выводом postgis_scripts_released(), то, вероятно, вы не выполнили должным образом апгрейд существующей базы. Смотрите подробности в разделе Обновление.
Присутствует с 0.9.0.
Возвращает номер версии скрипта lwpostgis.sql, предоставляемого с установкой библиотеки PostGIS.
Начиная с версии 1.1.0 эта функция возвращает то же значение, что и postgis_lib_version(). Оставлена для обратной совместимости.
Присутствует с 0.9.0.
Возвращает номер версии библиотеки GEOS, или NULL, если поддержка GEOS не включена.
Присутствует с 0.9.0
Возвращает номер версии библиотеки JTS, или NULL, если поддержка JTS не включена.
Присутствует с 1.1.0
Возвращает номер версии библиотеки PROJ4, или NULL, если поддержка PROJ4 не включена.
Присутствует с 0.9.0
Возвращает true, если включено использование STATS, и false в противном случае.
Присутствует с 0.9.0
Сообщает полную версию PostGIS и информацию о конфигурации сборки.
Присутствует с 0.9.0
Оператор "&<" возвращает true, если охват A частично совпадает или находится слева от охвата B.
Оператор "&>" возвращает true, если охват A частично совпадает или находится справа от охвата B.
Оператор "<<" возвращает true, если охват A находится строго слева от охвата B.
Оператор ">>" возвращает true, если охват A находится строго справа от охвата B.
Оператор "&<|" возвращает true, если охват A частично совпадает или находится ниже охвата B.
Оператор "|&>" возвращает true, если охват A частично совпадает или находится выше охвата B.
Оператор "<<|" возвращает true, если охват A находится строго ниже охвата B.
Оператор "|>>" возвращает true, если охват A находится строго выше охвата B.
Оператор "~=" - это оператор "то же самое". Он проверяет, являются ли обе части геометрически эквивалентными. Так, если A и B совпадают "вершина-в-вершину", то оператор вернет true.
Оператор "@" возвращает true, если охват A полностью содержит охват B.
Оператор "~" возвращает true, если охват A полностью содержится в охвате B.
Оператор "&&" является оператором "частичного перекрытия" ("overlaps"). Если охват A частично перекрывается охватом B, то оператор вернет true.
Возвращает площадь геометрии, являющейся полигоном или мультиполигоном.
Возвращает линейное расстояние в метрах между двумя точками (широта/долгота). Вычисление производится для сферы радиусом 6370986 метров (Земля). Работает быстрее, чем distance_spheroid(), но менее точно. Выполняется только для точек.
Возвращает линейное расстояние в метрах между двумя точками (широта/долгота) на заданном сфероиде. Смотрите определение сфероида, данное для length_spheroid(). В настоящее время выполняется только для точек.
Возвращает 2-мерную длину (2-dimensional length) геометрии, если она является линией или мульти-линией.
Возвращает 3-мерную длину (3-dimensional length) геометрии, если она является линией или мульти-линией.
Вычисляет длину геометрии на эллипсоиде. Может быть полезна, если координатами геометрии являются широта/долгота и длину желательна вычислить без перепроектирования без репроекции. Эллипсоид является особым тип базы данных и может быть сконструирован следующим способом:
SPHEROID[<NAME>,<SEMI-MAJOR AXIS>,<INVERSE FLATTENING>]
Например:
SPHEROID["GRS_1980",6378137,298.257222101]
Пример вычисления должен быть таким:
SELECT length_spheroid( geometry_column, 'SPHEROID["GRS_1980",6378137,298.257222101]' ) FROM geometry_table;
Вычисляет длину геометрии на эллипсоиде с учетом высоты. Это аналогично length_spheroid, но учитывает вертикальные координаты (выраженные в тех же единицах, что и оси сфероида), и используется для расчета дополнительного расстояния, которое добавляется вертикальным смещением.
Возвращает наименьшее расстояние между двумя геометриями.
Возвращает наибольшее расстояние между двумя линиями.
Возвращает 2-мерный периметр геометрии, если она является полигоном или мульти-полигоном.
Возвращает 2-мерный периметр геометрии, если она является полигоном или мульти-полигоном.
Возвращает 3-мерный периметр геометрии, если она является полигоном или мульти-полигоном.
Возвращает азимут сегмента, определенного заданными точечными геометриями, или NULL, если обе точки совпадают. Возвращает значение в радианах.
Присутствует с 1.1.0
Возвращает геометрию в "известном-бинарном" ("well-known-binary") формате OGC, как набор байтов с использованием little-endian (NDR) или big-endian (XDR) порядка байтов. Это используется в бинарном курсоре для вывода данных из базы без преобразования их к строковому представлению.
Возвращает геометрию в формате EWKT (как текст).
Возвращает геометрию в формате EWKB, как набор байтов с использованием little-endian (NDR) или big-endian (XDR) порядка байтов.
Возвращает геометрию в формате HEXEWKB, как текстс использованием little-endian (NDR) или big-endian (XDR) порядка байтов.
Возвращает геометрию как данные SVG. При использовании 1 в качестве второго аргумента, данные выдаются в терминах относительного движения. По умолчанию, (0) выдаются данные в терминах абсолютного движения. Третий аргумент может быть использован для сокращения максимума чисел после запятой в выводе (по умолчанию - 15). Точечные геометрии будут выданы как cx/cy, когда аргумент 'rel' равен 0, и как x/y, когда 'rel' равен 1.
Возвращает геометрию, как элемент GML. Параметр version, если указан, должен быть либо 2, либо 3. Если параметр version не указан, то используется значение по умолчанию 2. Третий аргумент может быть использован для ограничения максимума числа значащих цифр в выводе (по умолчанию - 15).
Возвращает геометрию как элемент KML. Второй аргумент может быть использован для ограничения максимума числа значащих цифр в выводе (по умолчанию - 15).
Возвращает геометрию как элемент GeoJson. (См. GeoJson specifications 1.0). Поддерживаются и 2D и 3D геометрии. GeoJson поддерживает только тип геометрии SFS 1.1 (например не поддерживаются кривые ).
Параметр version если указан должен быть равен 1.
Третий параметр может быть использован для уменьшения количества значимых разрядов чисел (по умолчанию 15).
Последний параметр 'options' может быть использован для добавления Bbox или Crs в вывод GeoJSON:
Создает геометрию из EWKT.
Создает геометрию из EWKB.
Создает точку 2d-, 3dz- или 4d-геометрии.
Создает точку 3dm-геометрии.
Создает BOX2D, определенный с помощью заданных точечных геометрий.
Создает BOX3D, определенный с помощью заданных точечных геометрий.
Создает линию из множества точечных геометрий. При аггрегровании вы можете использовать вложенный SELECT для упорядочения точек перед созданием линии.
Создает Linestring с помощью двух заданных точечных геометрий.
Создает Linestring с помощью геометрии MultiPoint.
Создает полигон, сформированный с помощью данного остова и массива дыр. Вы можете создать геометрический массив с помощью Accum. Вводимые геометрии должны быть замкнутыми ломаными (смотрите IsClosed и GeometryType).
Создает полигональную геометрию, сформированную с помощью линий, составляющих заданную геометрию. Возвращаемый тип может быть полигоном или мультиполигоном в зависимости от ввода. Если вводимые линии не образуют полигона, возвращается NULL.
Смотрите также BdPolyFromText и BdMPolyFromText - обертки этой функции со стандартным интерфейсом OGC.
Поддерживается с 1.1.0. Требует GEOS >= 2.1.0.
Аггрегировать. Создает GeometryCollection, содержащий возможные полигоны, сформированные из составных линий указанного множества геометрий.
Поддерживается с 1.0.0RC1. Требует >= 2.1.0.
Функция возвращает GEOMETRYCOLLECTION или MULTI-объект для множества геометрий. Функция collect() является "агрегирующей" в терминологии PostgreSQL. Это означает, что она оперирует списком данных, наподобие того, как это делают функции sum() и mean(). Например, "SELECT COLLECT(GEOM) FROM GEOMTABLE GROUP BY ATTRCOLUMN" вернет отдельный GEOMETRYCOLLECTION для каждого уникального значения ATTRCOLUMN.
ST_Collect и ST_Union часто взаимозаменяемы. ST_Collect на обычных запросах на порядок быстрее чем ST_Union потому что он не пытается растворить границы. Он просто сводит единичные геометрии в MULTI и MULTI или смешанные геометрии в Geometry Collections. К сожалению, коллекции не очень хорошо поддерживаются инструментарием ГИС. Чтобы избежать возвращения ST_Collect коллекций геометрии при сборе MULTI геометрий, можно использовать следующий подход, который использует ST_Dump для раскрытия коллекции в единичные геометрии и объединение их в группы:
Thread ref: http://postgis.refractions.net/pipermail/postgis-users/2008-June/020331.html SELECT stusps, ST_Multi(ST_Collect(f.the_geom)) as singlegeom FROM (SELECT stusps, (ST_Dump(the_geom)).geom As the_geom FROM somestatetable ) As f GROUP BY stusps
Эта функция возращает геометрию, которая является коллекцией двух введенных геометрий. Вывод будет иметь тип MULTI* или GEOMETRYCOLLECTION.
Это функция возвращает множество (SRF - set-returning function). Она возвращает набор строк geometry_dump, сформированных в виде геометрии (geom) и массива целых чисел (path). Если введенная геометрия имеет простой тип (POINT, LINESTRING, POLYGON), будет возвращена единственная запись с пустым массивом "path" и введеной геометрией в качестве "geom". Если введенная геометрия является коллекцией или MULTI, то будет возвращено по записи на каждую компоненту коллекции, а "path" будет указывать позицию компоненты внутри коллекции.
Эта функция полезна для раскрытия геометрий. Она является противоположной функции GROUP BY в том, что она создает новые строки. Например, она может быть использована для раскрытия MULTIPOLYGONS в POLYGONS.
SELECT sometable.*, (ST_Dump(the_geom)).geom As the_geom FROM somestatetable
Поддерживается с PostGIS 1.0.0RC1. Требует PostgreSQL 7.3 или выше.
Это функция возвращает множество (SRF - set-returning function). Она возвращает набор строк geometry_dump, сформированных в виде геометрии (geom) и массива целых чисел (path). Поле "path" является индексом полигонального круга, содержащим единственный элемент: 0 для остова, номер дырки для дырок. Поле "geom" содержит соответствующую дугу, как полигон.
Поддерживается с PostGIS 1.1.3. Требует PostgreSQL 7.3 или выше.
Добавляет к геометрии охват. Это приведет к ускорению запросов, основанных на охватах, но увеличивает размер геометрий.
Удаляет из геометрии кэш охватов. Это уменьшает размер геометрии, но замедляет запросы, использующие охваты.
Добавляет точку в линию после точки <pos> (нумерация начинается с 0). Третим параметром можно пренебречь или установить в -1, что одно и то же.
Удаляет точку линии. Offset начинается с 0.
Поддерживается с 1.1.0.
Заменяет точку N линии на заданную точку. Нумерация начинается с 0.
Поддерживается с 1.1.0.
Конвертирует геометрию в GEOMETRYCOLLECTION. Может быть использована для упрощения представления WKB.
Приводит геометрию в "2-мерный режим", так чтобы весь вывод был представлен только в координатах X и Y. Это может быть полезно для OGC-совместимого вывода (поскольку OGC определяет только 2-D геометрии).
Переводит геометрии в режим XYZ.
Переводит геометрии в режим XYM.
Переводит геометрии в режим XYZM.
Возвращает геометрию как геометрию MULTI*. Если данная геометрия уже является MULTI*, она будет возвращена неизменившейся.
Возвращает новую геометрии, все координаты которой трансформированы соответственно SRID, указанному как целочисленный параметр. Назначенный SRID должен существовать в таблице SPATIAL_REF_SYS.
Осуществляет 3d аффинную трансформацию геометрии. Команда:
Affine(geom, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff)
представляет матрицу трансформации:
/ a b c xoff \ | d e f yoff | | g h i zoff | \ 0 0 0 1 /
Вершины будут трансформированы следующим образом:
x' = a*x + b*y + c*z + xoff y' = d*x + e*y + f*z + yoff z' = g*x + h*y + i*z + zoff
Все команды сдвига/масштабирования (translate/scale), описанные ниже, являются частными случаями данного аффинного преобразования.
Поддерживается с 1.1.2.
Осуществляет 2d аффинную трансформацию геометрии. Команда:
Affine(geom, a, b, d, e, xoff, yoff)
представляет матрицу трансформации:
/ a b 0 xoff \ / a b xoff \ | d e 0 yoff | rsp. | d e yoff | | 0 0 1 0 | \ 0 0 1 / \ 0 0 0 1 /
Вершины будут трансформированы следующим образом:
x' = a*x + b*y + xoff y' = d*x + e*y + yoff z' = z
Этот метод является частностью 3D-метода, описанного выше.
Поддерживается с 1.1.2.
Переводит геометрию в новое местоположение с помощью числовых параметров смещения. Пример: translate(geom, X, Y, Z).
Масштабирует геометрию в новый размер путем умножения координат на соответствующие параметры. Например: scale(geom, Xfactor, Yfactor, Zfactor).
Поддерживается с 1.1.0.
Поворачивает геометрию вокруг оси Z, X или Y на угол, заданный в радианах. Согласно правилу правой руки.
Поддерживается с 1.1.2.
Сначала смещает геометрию с помощью первых двух значений, а потом масштабирует ее с помощью вторых двух чисел. Работает только с 2D. Вызов transscale(geom, X, Y, XFactor, YFactor) внутри приводит к вызову affine(geom, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, X*XFactor, Y*YFactor, 0).
Поддерживается с 1.1.0.
Возвращает геометрию с противоположным порядком вершин.
Приводит коллекцию полигонов в соответствие с "правилом правой руки".
Возвращает "упрощенную" версию данной геометрии с помощью алгоритма Дугласа-Пойкера (Douglas-Peuker). На самом деле будет работать только (мульти)линии и (мульти)полигоны, но вы можете безбоязненно применять ее к любым типам геометрий. Так как упрощение осуществляется пообъектно (object-by-object), вы можете использовать эту функцию и для GeometryCollection. Заметим, что возвращенная геометрия может не быть простой (смотрите IsSimple).
Прищелкивает все точки введенной геометрии к гриду, описанному координатами начала и размерами ячеек. Удаляет точки, попадающие в те же ячейки и, в конечном счете, возвращает NULL, если выведенных точек недостаточно, чтобы определить геометрию данного типа. Свернутые геометрии удаляются из коллекции.
Возвращаемая геометрия может перестать быть простой (смотрите IsSimple).
До релиза 1.1.0 эта функция всегда возвращала 2d-геометрию. Начиная с 1.1.0 возвращаемая геометрия будет иметь ту же размерность, что и введеная. Размерности высших порядков остаются нетронутыми. Используйте версию, берущую второй геометрический аргумент, чтобы определить все измерения грида.
Поддерживается с 1.0.0RC1.
Прищелкивает все точки введенной геометрии к гриду, описанному началом (второй аргумент, должен быть точкой) и размерами ячеек. Если вы не хотите осуществлять прищелкивание, укажите любой размер равным 0.
Поддерживается с 1.1.0.
Возвращает модифицированную геометрию без секторов, с длиной больше указанного размера. Интерполированные точки будут иметь значения Z и M (если они нужны), установленные в 0. Вычисление размеров производится только в 2d.
Возвращает линию или линии, сформированную(ые) посредством соединения линий, составляющих ввод.
Поддерживается с 1.1.0. Требует GEOS >= 2.1.0
Возвращает точки, интерполированные вдоль линии. Первый аргумент должен иметь тип LINESTRING. Второй аргумент является float8 между 0 и 1, представляющим дробную часть всей 2d-длины где должны быть раположены точки.
Смотрите line_locate_point(), чтобы вычислить местоположение линии, самое близкое к точке.
Начиная с релиза 1.1.1 эта функция также интерполирует значения M и Z (если они есть), тогда как предыдущие релизы устанавливали их в 0.0.
Поддерживается с 0.8.2.
Возвращает линию как часть первого аргумента, начинающегося и заканчивающегося заданными долями. Второй и третий аргумент должны быть значениями float8 между 0 и 1.
Если 'start' и 'end' имеют одинаковые значения, это эквивалентно line_interpolate_point().
Смотрите line_locate_point() про вычисление линии местоположения, ближайшей к точке.
Начиная с релиза 1.1.1 эта функция также интерполирует значения M и Z (если они есть), тогда как предыдущие релизы устанавливали их в неопределенное значение.
Поддерживается с 1.1.0.
Возвращается float между 0 и 1, представляющий местонахождение вершины линии ближайшей к указанной точке, как отношение к общей длине 2d-линии.
Вы можете использовать полученное местоположение для извлечения точки (line_interpolate_point) или части линии (line_substring).
Поддерживается с 1.1.0.
Возвращает значение производной геометрии, элементы которой соответствуют указанной мере. Полигональные элементы не поддерживаются.
Семантика специфицирована в ISO/IEC CD 13249-3:200x(E) - Текст продолжен на CD редакционного заседания.
Поддерживается с 1.1.0.
Возвращает производную геометрическую коллекцию с элементами, которые включают в себя указанный диапазон мер. Полигональные элементы не поддерживаются.
Семантика определена в ISO/IEC CD 13249-3:200x(E) - Текст продолжен на CD редакционного заседания.
Поддерживается с 1.1.0.
Возвращает текстовое резюме содержания геометрии.
Возвращает BOX2D, представленный максимальным охватом геометрии.
Возвращает BOX3D, представленный максимальным охватом геометрии.
Функция extent() является "агрегирующей" функцией в терминологии PostgreSQL. Это означает, что она оперирует набором данных, аналогично тому, как это делают функции sum() и mean(). Например, "SELECT EXTENT(GEOM) FROM GEOMTABLE" возвратит BOX3D с максимальными протяженностями для всего содержимого таблицы. Аналогично, "SELECT EXTENT(GEOM) FROM GEOMTABLE GROUP BY CATEGORY" возвратит по одному результату для каждой категории.
Возвращает флаг ZM (семантическая размерность - dimension semantic) указанной геометрии, как малое целое (small int). Значения: 0=2d, 1=3dm, 2=3dz, 3=4d.
Возвращает TRUE, если охват геометрии является кэшированным. В противном случае - FALSE. Используйте addBBOX() и dropBBOX() для управления кэшированием.
Возвращает число размерностей геометрии, как малое целое (small int). Значения: 2, 3 или 4.
Если геометрия является полигоном или мультиполигоном, возвращает число кругов.
Возвращает число точек в геометрии.
Возвращает true, если геометрия является валидной.
Эта функция возвращает охват геометрии, расширенный во всех направлениях на значение, указанное во втором аргументе. Очень удобно использовать эту функцию при запросах distance() для добавления к запросу фильтра по индексу.
Возвращает "оценочный" охват данной пространственной таблицы. Оценка берется из статистики столбцов геометрии. Используется текущая схема если не определена другая.
В PostgreSQL>=8.0.0 сбор статистики осуществляется с помощью VACUUM ANALYZE, и результат будет составлять около 95% от реального.
В PostgreSQL<8.0.0 сбор статистики осуществляется с помощью update_geometry_stats(), и результат будет точным.
Синтаксис является следующим: find_srid(<БД/схема>, <таблица>, <столбец>). Функция возвращает целочисленный SRID указанного столбца, находящийся в таблице GEOMETRY_COLUMNS. Если геометрический столбец не был должным образом создан с помощью функции AddGeometryColumns(), эта функция будет работать неправильно.
Возвращает размер (в байтах), занимаемый геометрией.
Синтаксис этой функции: point_inside_circle(<геометрия>, <центр_круга_x>, <центр_круга_y>, <радиус>). Возвращает true, если данная геометрия является точкой и находится внутри круга. В противном случае возвращает false.
Возвращает запрошенный минимальный охват.
Возвращает запрошенный максимальный охват.
Аггрегация. Строит массив геометрий.
Этот модуль и ассоциированные функции pl/pgsql может быть использован для организации поддержки долгих блокировок, описанных в спецификации Web Feature Service.
Пользователи должны использовать сериализуемый уровень транзакции, иначе механизм блокировок может не работать.
Включить поддержку долгих транзакций. Эта функция создает необходимые метаданные таблиц; должна быть вызвана перед использованием других функций этого раздела. Повторный вызов безвреден.
Поддерживается с 1.1.3.
Отключить поддержку долгих транзакций. Эта функция удаляет метаданные таблиц, поддерживающие долгие транзакции, и удаляет все триггеры, добавленные к заблокированным таблицам.
Поддерживается с 1.1.3.
Проверяет UPDATE и DELETE записей данной таблицы на авторизацию. Идентифицирует строки с помощью столбца <rowid_col>.
Поддерживается с 1.1.3.
Устанавливает блокировку/авторизацию для указанной записи в таблице. <authid> является текстовым значением, <expires> - временная метка, по умолчанию равная now()+1hour. Возвращает 1, если блокировка прошла успешно, и 0 - в противном случае (уже заблокирована другим пользователем).
Поддерживается с 1.1.3.
Снять все блокировки, проведенные с указанным идентификатором авторизации. Возвращает число всех снятых блокировок.
Поддерживается с 1.1.3.
Добавляет признак авторизации для использования в текущей транзакции.
Поддерживается с 1.1.3.
<<< предыдущая глава | оглавление | следующая глава >>>
Обсудить в форуме Комментариев 21
Последнее обновление: December 01 2008
© GIS-Lab и авторы, 2002-2021. При использовании материалов сайта, ссылка на GIS-Lab и авторов обязательна. Содержание материалов - ответственность авторов. (подробнее).