Dados GeoJSON de delimitação geográfica

A API GET Geofence e POST Geofence do Azure Maps permitem recuperar a proximidade de uma coordenada em relação a uma cerca geográfica ou conjunto de cercas fornecido. Este artigo detalha como preparar os dados de cerca geográfica que podem ser usados na API GET e POST do Azure Maps.

Os dados para geofence ou conjunto de geofences, representados pelo Feature Object e FeatureCollection Object no GeoJSON formato, são definidos em rfc7946. Além disso:

• O tipo de objeto GeoJSON pode ser um Feature objeto ou um FeatureCollection objeto.
• O tipo de objeto Geometria pode ser um Point, MultiPoint, , LineString, MultiLineString, MultiPolygonPolygon, e GeometryCollection.
• Todas as propriedades do recurso devem conter um geometryIdarquivo , que é usado para identificar a cerca geográfica.
• Recurso com Point, MultiPoint, LineString, deve MultiLineString conter radius em propriedades. radius valor é medido em metros, o radius valor varia de 1 a 10000.
• Recurso com polygon e multipolygon tipo de geometria não tem uma propriedade radius.
• validityTime é uma propriedade opcional que permite ao usuário definir o tempo expirado e o período de validade para os dados da cerca geográfica. Se não for especificado, os dados nunca expiram e são sempre válidos.
• A expiredTime é a data e hora de expiração dos dados de cerca geográfica. Se o valor de na solicitação for posterior a esse valor, os dados de userTime cerca geográfica correspondentes serão considerados como dados expirados e não serão consultados. No qual, o geometryId desses dados de cerca geográfica é incluído na expiredGeofenceGeometryId matriz dentro da resposta de cerca geográfica.
• O validityPeriod é uma lista de período de tempo de validade da cerca geográfica. Se o valor de na solicitação estiver fora do período de validade, os dados de userTime cerca geográfica correspondentes serão considerados inválidos e não serão consultados. O geometryId desses dados de cerca geográfica está incluído na invalidPeriodGeofenceGeometryId matriz dentro da resposta de cerca geográfica. A tabela a seguir mostra as propriedades do elemento validityPeriod.

Nome	Type	Obrigatório	Descrição
startTime	Datetime	verdadeiro	A data de início do período de tempo de validade.
endTime	Datetime	verdadeiro	A hora da data final do período de tempo de validade.
Tipo de recorrência	string	false	O tipo de recorrência do período. O valor pode ser Daily, Weekly, Monthly, ou Yearly. O valor predefinido é Daily.
businessDayOnly	Booleano	false	Indique se os dados só são válidos durante dias úteis. O valor predefinido é false.

• Todos os valores de coordenadas são representados como [longitude, latitude] definidos em WGS84.
• Para cada Recurso, que contém MultiPoint, MultiLineString, MultiPolygon , ou GeometryCollection, as propriedades são aplicadas a todos os elementos. por exemplo: Todos os pontos usam MultiPoint o mesmo raio para formar uma cerca geográfica de vários círculos.
• No cenário de círculo de pontos, uma geometria de círculo pode ser representada usando um Point objeto de geometria com propriedades elaboradas em Estendendo geometrias GeoJSON.

A seguir está um corpo de solicitação de amostra para uma cerca geográfica representada como uma geometria de cerca geográfica circular usando GeoJSON um ponto central e um raio. O período válido dos dados da cerca geográfica começa das 9h às 17h, repetindo-se todos os dias, exceto no fim de 2018-10-22semana. expiredTime indica que esses dados de cerca geográfica são considerados expirados, se userTime na solicitação for posterior a 2019-01-01.

{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [-122.126986, 47.639754]
    },
    "properties": {
        "geometryId" : "1",
        "subType": "Circle",
        "radius": 500,
        "validityTime": 
        {
            "expiredTime": "2019-01-01T00:00:00",
            "validityPeriod": [
                {
                    "startTime": "2018-10-22T09:00:00",
                    "endTime": "2018-10-22T17:00:00",
                    "recurrenceType": "Daily",
                    "recurrenceFrequency": 1,
                    "businessDayOnly": true
                }
            ]
        }
    }
}