Geometrías GeoJSON extendidas

Artículo
04/17/2023

Azure Maps proporciona una lista de API eficaces para buscar dentro de características geográficas o junto a ellas. Estas API se adhieren a la especificación de GeoJSON estándar de representación de características geográficas.

La especificación de GeoJSON solo admite las geometrías siguientes:

GeometryCollection
LineString
MultiLineString
MultiPoint
MultiPolygon
Punto
Polygon

Algunas API de Azure Maps aceptan geometrías que no forman parte de la especificación de GeoJSON. Por ejemplo, Search Inside Geometry API acepta círculos y polígonos.

Este artículo proporciona una explicación detallada sobre cómo Azure Maps amplía las especificaciones de GeoJSON para representar determinadas geometrías.

Circle

La especificación GeoJSON no admite la geometría Circle. El objeto GeoJSON Point Feature se usa para representar un círculo.

Una geometría Circle representada mediante el objeto GeoJSON Featuredebe contener las propiedades y coordenadas siguientes:

Coordenada	Propiedad
Center	El centro del círculo se representa mediante un objeto `GeoJSON Point`.
Radio	`radius` se representa mediante las propiedades de `GeoJSON Feature`. El valor del radio está en metros y debe ser del tipo `double`.
SubType	La geometría del círculo también debe contener la propiedad `subType`. Esta propiedad debe formar parte de las propiedades de `GeoJSON Feature` y su valor debe ser Circle.

Ejemplo de círculo

Así se representa un círculo con un objeto GeoJSON Feature. Vamos a centrar el círculo en latitud: 47,639754 y longitud: -122,126986, y asígnele un radio igual a 100 metros:

{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [-122.126986, 47.639754]
    },
    "properties": {
        "subType": "Circle",
        "radius": 100
    }
}

Rectángulo

La especificación GeoJSON no admite la geometría Rectangle. El objeto GeoJSON Polygon Feature se usa para representar un rectángulo. La extensión de rectángulo se usa principalmente en el módulo de herramientas de dibujo del SDK para web.

Una geometría Rectangle representada mediante el objeto GeoJSON Polygon Featuredebe contener las propiedades y coordenadas siguientes:

Coordenada	Propiedad
Esquinas	Las esquinas del rectángulo se representan mediante las coordenadas de un objeto `GeoJSON Polygon`. Debería haber cinco coordenadas, una para cada vértice. Y una quinta coordenada igual que la primera para cerrar el anillo del polígono. Se supone que estas coordenadas se alinean y que el desarrollador puede rotarlas según lo desee.
SubType	La geometría del rectángulo también debe contener la propiedad `subType`. Esta propiedad debe formar parte de las propiedades de `GeoJSON Feature` y su valor debe ser Rectangle.

Ejemplo de rectángulo

{
    "type": "Feature",
    "geometry": {
        "type": "Polygon",
        "coordinates": [[[5,25],[14,25],[14,29],[5,29],[5,25]]]
    },
    "properties": {
        "subType": "Rectangle"
    }
}

Pasos siguientes

Más información sobre los datos de GeoJSON en Azure Maps:

Formato de Geofence GeoJSON

Revise el glosario de términos técnicos comunes asociados a las aplicaciones de Azure Maps y de inteligencia de ubicación:

Glosario de Azure Maps

Compartir vía