Geofencing GeoJSON data

Rozhraní API Geofence a POST Geofence služby Azure Maps umožňují načíst blízkost souřadnic vzhledem k zadané geografické fence nebo sadě plotů. Tento článek podrobně popisuje, jak připravit data geografické zóny, která se dají použít v rozhraní AZURE Maps GET a POST API.

Data pro geofence nebo sadu geofence reprezentovaných objektem a objektem Feature ve GeoJSON formátu jsou definována v dokumentu rfc7946FeatureCollection. Kromě toho:

• Typ objektu Feature GeoJSON může být objekt nebo FeatureCollection objekt.
• Typ objektu geometrie může být , , LineString, , , MultiPolygon, a GeometryCollection. PolygonMultiLineStringMultiPointPoint
• Všechny vlastnosti funkce by měly obsahovat vlastnost geometryId, která se používá k identifikaci geografické zóny.
• Funkce s Point, MultiPoint, LineStringMultiLineString musí obsahovat radius ve vlastnostech. radius hodnota se měří v metrech, radius rozsah hodnot je od 1 do 1 0000.
• Funkce s typem polygon multipolygon geometrie nemá vlastnost poloměru.
• validityTime je volitelná vlastnost, která uživateli umožňuje nastavit čas vypršení platnosti a časové období platnosti pro data geografické zóny. Pokud není zadáno, data nikdy nevyprší a jsou vždy platná.
• Jedná se expiredTime o datum a čas vypršení platnosti dat geofencingu. Pokud je hodnota userTime v požadavku pozdější než tato hodnota, považují se odpovídající data geofence za data s vypršenou platností a nejsou dotazována. Po kterém je geometryId těchto dat geografické zóny zahrnuta do expiredGeofenceGeometryId pole v rámci odpovědi geografické zóny.
• Jedná se validityPeriod o seznam časových období platnosti geofence. Pokud hodnota userTime v požadavku spadá mimo dobu platnosti, odpovídající data geografické zóny se považují za neplatná a nejsou dotazována. GeometryId těchto dat geografické zóny jsou zahrnuty do pole v invalidPeriodGeofenceGeometryId rámci odpovědi geofence. Následující tabulka uvádí vlastnosti prvku validityPeriod.

Name	Type	Požadováno	Popis
startTime	Datum a čas	true	Počáteční datum časového období platnosti.
endTime	Datum a čas	true	Koncové datum časového období platnosti.
recurrenceType	string	false (nepravda)	Typ opakování období. Hodnota může být Daily, Weekly, Monthlynebo Yearly. Výchozí hodnota je Daily.
businessDayOnly	Logický	false (nepravda)	Určuje, jestli jsou data platná jenom během pracovních dnů. Výchozí hodnota je false.

• Všechny hodnoty souřadnic jsou reprezentovány jako [zeměpisná délka, zeměpisná šířka] definované v WGS84.
• Pro každou funkci, která obsahuje MultiPoint, MultiLineStringMultiPolygon GeometryCollectionnebo , se vlastnosti použijí na všechny prvky. Příklad: Všechny body, které MultiPoint používají stejný poloměr k vytvoření více kruhové geografické zóny.
• Ve scénáři s bodovým kruhem lze geometrii kruhu reprezentovat pomocí Point objektu geometrie s vlastnostmi propracovanými v rozšíření geometrických geometrií GeoJSON.

Následuje ukázkový text požadavku pro geofence reprezentovaný jako geometrie geofence kruhu při GeoJSON použití středového bodu a poloměru. Platné období dat geografické zóny začíná od 2018-10-22, 9:00 do 5:00, opakuje se každý den s výjimkou víkendu. expiredTime označuje, že tato data geografické zóny jsou považována za ukončenou, pokud userTime je v požadavku pozdější než 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
                }
            ]
        }
    }
}