Detalles de las funciones SQL espaciales
ST_AREA
ST_AREA devuelve el área cartesiana o geodésica de una geometría.
El área se calcula según la unidad de medida especificada al definir la geometría.
Formato:
<Area> = ST_AREA(<Geometry>)
Donde:
- <Area>: Área (superficie) calculada en la unidad especificada.
- <Geometry>: Geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
La unidad del valor devuelto depende de la unidad del sistema de referencia espacial (SRS) utilizada para definir la geometría (metros, pies, etc.).
Ejemplo: Este ejemplo devuelve la superficie de cada parcela de la tabla "Parcel".
SELECT ST_AREA(GeoParcel) AS CityArea
FROM Parcels
ST_CONTAINS
ST_CONTAINS determina si una geometría contiene otra geometría (en coordenadas 2D o geográficas), es decir, si todos los puntos de la geometría que se va a comparar se encuentran en la geometría de referencia.
Formato:
<Status> = ST_CONTAINS(<Reference geometry>, <Geometry to compare>)
Donde:
- <Status>: Valor de retorno (boolean):
- True si la geometría a comparar está contenida en la geometría de referencia.
- False en caso contrario.
- <Reference geometry>: Geometría de referencia de la comparación. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry to compare>: Geometría a comparar con la geometría de referencia. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Este ejemplo devuelve el nombre de la ciudad que contiene la parcela definida por la geometría de referencia RefPark (busca la ciudad en la que se encuentra una parcela).
SELECT CityID, CityName FROM Cities
WHERE ST_CONTAINS(GeoCity, RefPark)
ST_COVEREDBY
ST_COVEREDBY determina si todos los puntos de la primera geometría están dentro de la segunda geometría, o si al menos uno de los puntos de la primera geometría no está dentro de la segunda geometría.
Nota: Esta función es equivalente a ST_COVERS, pero con los parámetros en orden inverso.
Formato:
<Status> = ST_COVEREDBY(<Geometry 1>, <Geometry 2>)
donde:
- <Status>: Valor de retorno (boolean):
- True si todos los puntos de la primera geometría se encuentran dentro de la segunda geometría.
- False si al menos uno de los puntos de la primera geometría no está dentro de la segunda geometría.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Encontrar todas las ciudades que se encuentran dentro o en la frontera de un estado.
La ciudad y el estado están representados por las geometrías "GeoTown" y "GeoRefState".
SELECT TownName FROM TownMap
WHERE ST_COVEREDBY(GeoTown, GeoRefState)
ST_COVERS
ST_COVERS determina si todos los puntos de la segunda geometría están dentro de la primera geometría, o si al menos uno de los puntos de la segunda geometría no está dentro de la primera geometría.
Nota: Esta función es equivalente a ST_COVEREDBY, pero con los parámetros en orden inverso.
Formato:
<Status> = ST_COVERS(<Geometry 1>, <Geometry 2>)
donde:
- <Status>: Valor de retorno (boolean):
- True si cada punto de la segunda geometría está dentro de la primera geometría.
- False si al menos uno de los puntos de la segunda geometría no está dentro de la primera geometría.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Encontrar todas las ciudades que se encuentran dentro o en la frontera de un estado.
La ciudad y el estado están representados por las geometrías "GeoTown" y "GeoRefState".
SELECT TownName FROM TownMap
WHERE ST_COVERS(GeoRefState, GeoTown)
ST_CROSSES
ST_CROSSES determina si dos geometrías tienen algunos puntos interiores en común.
La intersección representada por estos puntos en común debe cumplir dos condiciones:
- la dimensión de esta intersección debe ser menor que las dimensiones de las geometrías que se comparan.
- esta intersección no debe ser igual a una de las geometrías comparadas.
Formato:
<Status> = ST_CROSSES(<Geometry 1>, <Geometry 2>)
Donde:
- <Status>: Valor de retorno (boolean):
- True si una de las geometrías tiene algunos de sus puntos interiores en común con la segunda geometría, y se cumplen las condiciones.
- False en caso contrario. En este caso, o no se cumplen las dos condiciones, o no hay puntos interiores en común.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Buscar todos los países atravesados por un río.
El río y el país están representados por las geometrías "GeoRefRiver" y "GeoCountry".
SELECT CountryName FROM WorldCountriesMap
WHERE ST_CROSSES(GeoRefRiver, GeoCountry)
ST_DIFFERENCE
ST_DIFFERENCE devuelve una geometría que corresponde a la diferencia entre las dos geometrías pasadas como parámetros.
La geometría más pequeña se resta de la más grande, independientemente del orden en que se hayan pasado.
Formato:
<Resulting geometry> = ST_DIFFERENCE(<Geometry 1>, <Geometry 2>)
Donde:
- <Resulting geometry>: Geometría que representa la diferencia entre las dos geometrías.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Calcular la geometría que representa la superficie restante después de vender una parcela:
SELECT ST_DIFFERENCE(Land1, ParcelSold)
AS RemainingArea
FROM ParcelsPlot
WHERE LandID=1
ST_DISTANCE
ST_DISTANCE calcula la distancia cartesiana o geodésica mínima entre dos geometrías. Esta distancia se expresa en la unidad de medida especificada al definir la geometría.
Formato:
<Distance> = ST_DISTANCE(<Geometry 1>, <Geometry 2>)
Donde:
- <Distance>: Distancia calculada en la unidad especificada.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
La unidad del valor devuelto depende de la unidad del sistema de referencia espacial (SRS) utilizada para definir la geometría (metros, grados, etc.).
Ejemplo 1: Este ejemplo devuelve las distancias entre todas las ciudades de la tabla "Maps" y la ciudad de referencia "GeoRef".
SELECT ST_DISTANCE(GeoCity, GeoRef) AS Distance FROM Maps
: Este ejemplo devuelve la distancia entre las dos geometrías especificadas. Las geometrías se definen mediante polígonos.
SELECT
ST_DISTANCE(ST_GEOMFROMTEXT('POLYGON((-3 5,4 5.03,4 1.06,-3.03 0.97,-5.06 3.06,-3.09 5,-3.09 5,-3 5))'),
ST_GEOMFROMTEXT('POLYGON((4.03 9.03,7 9.11,6.94 7.06,4 7.97,3.97 9.06,4.03 9.03))'))
AS dist_2d
ST_EQUALS
ST_EQUALS determina si dos geometrías (en coordenadas 2D o geográficas) son iguales, es decir, si tienen las mismas dimensiones y sus puntos ocupan el mismo espacio.
Observación: Las coordenadas de las geometrías pueden ser diferentes (es decir, pueden no estar situadas en la misma posición).
Formato:
<Status> = ST_EQUALS(<Geometry 1>, <Geometry 2>)
Donde:
- <Status>: Valor de retorno (boolean):
- True si las dos geometrías son iguales,
- False en caso contrario.
- <Geometry 1>: Primera geometría a manipular. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría a manipular. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Este ejemplo devuelve la lista de parcelas que tienen el mismo tamaño y ocupan el mismo espacio que la parcela de referencia definida por la geometría "RefPark".
SELECT ParcelID, ParcelLocation FROM Parcels
WHERE ST_EQUALS(DefParcel, RefPark)
ST_GEOMFROMTEXT
ST_GEOMFROMTEXT construye una geometría 2D a partir de una representación de texto.
Formato:
<Geometry> = ST_GEOMFROMTEXT(<String>)
Donde:
- <Geometry>: Geometría bidimensional.
- <String>: Representación texto de una geometría.
Ejemplo: Este ejemplo calcula la distancia entre dos geometrías bidimensionales.
Las dos geometrías son polígonos representados por una serie de puntos descritos en una cadena. La cadena que describe el polígono se convierte en geometría mediante la función SQL ST_GEOMFROMTEXT.
SELECT
ST_DISTANCE(ST_GEOMFROMTEXT('POLYGON((-3 5,4 5.03,4 1.06,-3.03 0.97,-5.06 3.06,-3.09 5,-3.09 5,-3 5))'),
ST_GEOMFROMTEXT('POLYGON((4.03 9.03,7 9.11,6.94 7.06,4 7.97,3.97 9.06,4.03 9.03))'))
AS dist_2d
ST_INTERSECTS
ST_INTERSECTS determina si 2 geometrías (en coordenadas 2D o geográficas) tienen puntos en común. Este comando calcula el área común (intersección) entre las dos geometrías.
Formato:
<Status> = ST_INTERSECTS(<Geometry 1>, <Geometry 2>)
Donde:
- <Status>: Valor de retorno (boolean):
- True si las geometrías tienen al menos un punto en común,
- False en caso contrario.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Este ejemplo devuelve una lista de ciudades representadas por la geometría "GeoCity" que tienen un punto en común con la geometría de referencia "GeoRef".
SELECT CityName FROM Maps WHERE ST_INTERSECTS(GeoCity, GeoRef)
ST_LENGTH
ST_LENGTH devuelve la longitud (en metros) de una geometría lineal. Una geometría lineal (o polilínea) es una geometría compuesta por varios puntos conectados. La geometría debe estar compuesta por al menos dos puntos. El conjunto de puntos no debe formar una geometría cerrada, es decir, un polígono.
La longitud se obtiene a partir de la suma de cada línea que compone la polilínea.
Formato:
<Length> = ST_LENGTH(<Geometry>)
Donde:
- <Length>: Longitud calculada en metros.
- <Geometry>: Polilínea a manipular. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Si la geometría pasada como parámetro es un polígono o un solo punto, la función devolverá 0.
Ejemplo: Obtener la longitud de todos los ríos de Francia.
SELECT RiverName, ST_LENGTH(GeoRiver) AS RiverLength
FROM RiverMap WHERE Country='France'
ST_MAKEPOLYGON
ST_MAKEPOLYGON genera una geometría de tipo Polygon utilizando la descripción de una geometría.
Este comando puede tomar un segundo parámetro opcional que describe los anillos interiores de la geometría resultante. Estos anillos se definen mediante un array de polilíneas (un anillo corresponde a una polilínea).
Formato:
<Resulting geometry> = ST_MAKEPOLYGON(<Geometry to analyze>[, <Interior rings geometry] [, <SRID>])
Donde:
- <Resulting geometry>: Geometría que corresponde al polígono resultante.
- <Geometry to analyze>: Geometría compuesta de líneas sin los anillos interiores opcionales. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Interior rings geometry> (opcional): Geometría que describe los anillos interiores que deben integrarse en la geometría que se va a analizar. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <SRID> (opcional): En el caso de una geometría en coordenadas geográficas, indica el identificador de referencia espacial (SRID) definido en la descripción de la geometría.
Ejemplo: Construir un polígono rectangular que contiene un anillo interior.
SELECT ST_MAKEPOLYGON('LINESTRING(0 8, 6 8, 6 0, 0 0, 0 8)', 'LINESTRING(3 3, 3 5, 4 5,4 3, 3 3)');
ST_OVERLAPS
ST_OVERLAPS determina si dos geometrías se superponen y si su intersección tiene la misma dimensión que las geometrías originales. Ninguna de las geometrías debe ser un subconjunto de la otra.
Formato:
<Status> = ST_OVERLAPS(<Geometry 1>, <Geometry 2>)
Donde:
- <Status>: Valor de retorno (boolean):
- True si la geometría resultante se superpone con las geometrías pasadas como parámetros.
- False en caso contrario.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Obtener una lista de geometrías superpuestas.
SELECT ListObjects.NameObject1, ListObjectsRef.NameObjectRef
FROM ListObjects, ListObjectsRef
WHERE ListObjectsRef.FamilyID = ListObjects.FamilyID AND
ST_OVERLAPS(ListObjectsRef.GeoRef, ListObjects.geoObject)
ST_PERIMETER
ST_PERIMETER devuelve el perímetro (en metros) de la geometría especificada. El perímetro se calcula sumando cada segmento que constituye el límite de la geometría.
Formato:
<Perimeter> = ST_PERIMETER(<Geometry>)
Donde
- <Perimeter>: Perímetro calculado en metros.
- <Geometry>: Geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Ejemplo: Calcular el perímetro de cada parcela del lote número 15.
SELECT ParcelID, ST_PERIMETER(GeoParcel) AS ParcelPerimeter FROM Parcels WHERE PlotID=15
ST_SIMPLIFY
ST_SIMPLIFY devuelve una versión 'simplificada' de la geometría especificada. La nueva geometría se calcula mediante el algoritmo Ramer-Douglas-Peucker, con la tolerancia especificada.
Formato:
<Resulting geometry> = ST_SIMPLIFY(<Geometry>[, <Tolerance>)
Donde:
- <Resulting geometry>: Geometría simplificada.
- <Geometry>: Geometría utilizada. Esta geometría puede estar compuesta por varias geometrías. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Tolerance> (real opcional): Representa el nivel de tolerancia en metros para el cálculo de la geometría simplificada. Las geometrías que forman parte de la geometría original, pero cuya longitud es inferior al nivel de tolerancia, no se incluirán en la versión simplificada.
Ejemplo: Este ejemplo devuelve una representación simplificada de un objeto. Las geometrías pequeñas con una longitud inferior a 0,05 m no se representarán en la geometría resultante.
SELECT ObjectID, ST_SIMPLIFY(DetailedObject, 0.05) AS SimplifiedObject FROM ListObjects
ST_SYMDIFFERENCE
ST_SYMDIFFERENCE devuelve una geometría que representa la diferencia de dos geometrías pasadas como parámetros.
En la geometría resultante se excluyen todos los puntos comunes a ambas geometrías.
Esta operación corresponde a una "unión exclusiva".
Formato:
<Resulting geometry> = ST_SYMDIFFERENCE(<Geometry 1>, <Geometry 2>)
Donde:
- <Resulting geometry>: Geometría que representa la diferencia simétrica.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Obtener la geometría que corresponde a la unión exclusiva de las dos geometrías que componen el producto número 1.
SELECT ST_SYMDIFFERENCE(GeometryObject1, GeometryObject2) AS ResultingObject
FROM Objects
WHERE ProductID=1
ST_TOUCHES
ST_TOUCHES determina si dos geometrías tienen al menos un punto de sus límites respectivos en común.
Tenga en cuenta que las geometrías no deben tener ningún punto interior en común.
Formato:
<Status> = ST_TOUCHES(<Geometry 1>, <Geometry 2>)
Donde:
- <Status>: Valor de retorno (boolean):
- True si las dos geometrías tienen al menos un punto de sus límites en común.
- False en caso contrario. En este caso:
- no hay puntos en sus límites en común.
- uno de los puntos interiores de una de las geometrías interseca a la otra geometría.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Obtener la lista de países que comparten fronteras con el país de referencia.
"GeoCountryRef" representa el país de referencia para el que queremos encontrar los países fronterizos. "GeoCountry" representa el país que debe compararse con el país de referencia.
SELECT CountryName FROM ListCountries
WHERE ST_TOUCHES(GeoCountryRef, GeoCountry)
ST_UNION
ST_UNION devuelve una geometría que representa la unión entre dos geometrías.
La geometría resultante corresponde a la combinación de las dos geometrías originales. No se aplica ningún proceso particular a los puntos comunes.
Formato:
<Resulting geometry> = ST_UNION(<Geometry 1>, <Geometry 2>)
Donde:
- <Resulting geometry>: Geometría que representa la unión de dos geometrías.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría a manipular. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Calcular la geometría que representa el terreno resultante tras comprar y unir dos parcelas contiguas.
SELECT NewParcelID, ST_UNION(Parcel1, Parcel2) AS ResultingPlot
FROM ParcelsPlot
WHERE LandID=1
ST_WITHIN
ST_WITHIN determina si la primera geometría está contenida dentro de la segunda geometría, es decir, si todos los puntos de la primera geometría se encuentran dentro de la segunda geometría.
Formato:
<Status> = ST_WITHIN(<Geometry 1>, <Geometry 2>)
Donde
- <Status>: Valor de retorno (boolean):
- True si la primera geometría se encuentra dentro de la segunda geometría.
- False en caso contrario. Esto significa que al menos uno de los puntos de la primera geometría no se encuentra dentro de la segunda geometría.
- <Geometry 1>: Primera geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
- <Geometry 2>: Segunda geometría utilizada. Esta geometría puede ser:
- un campo de tipo "Datos geométricos" o "Datos geográficos".
- una cadena que contiene la descripción de la geometría.
Nota: Las dos geometrías deben ser del mismo tipo (dos geometrías en coordenadas 2D o geográficas).
Ejemplo: Obtener la lista de barcos que pasan por el Canal de Panamá.
"PosGeoShip" representa la posición del barco en tiempo real, y "GeoPanamaCanal" es una geometría que corresponde a una representación geográfica del Canal de Panamá.
SELECT ShipName FROM ListShips
WHERE ST_WITHIN(PosGeoShip, GeoPanamaCanal)