Condividi tramite

Mappe di Azure come origine di Griglia di eventi

Questo articolo fornisce le proprietà e lo schema per gli eventi di Mappe di Azure. Per un'introduzione agli schemi di eventi, vedere Schema di eventi di Griglia di eventi di Azure. Offre anche un elenco di guide introduttive e esercitazioni per l'uso di Mappe di Azure come origine evento.

Tipi di evento disponibili

Un account mappe di Azure genera i tipi di evento seguenti:

Tipo di evento Descrizione
Microsoft.Maps.GeofenceEntered Generato quando le coordinate ricevute sono state spostate dall'esterno di un determinato recinto virtuale all'interno
Microsoft.Maps.GeofenceExited Generato quando le coordinate ricevute sono state spostate dall'interno di un determinato recinto virtuale all'esterno
Microsoft.Maps.GeofenceResult Generato ogni volta che una query di geofencing restituisce un risultato, indipendentemente dallo stato

Eventi di esempio

Nell'esempio seguente viene illustrato lo schema di un evento GeofenceEntered

{   
   "id":"7f8446e2-1ac7-4234-8425-303726ea3981", 
   "source":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Maps/accounts/{accountName}", 
   "subject":"/spatial/geofence/udid/{udid}/id/{eventId}", 
   "data":{   
      "geometries":[   
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"2", 
            "distance":-999.0, 
            "nearestLat":47.618786, 
            "nearestLon":-122.132151 
         } 
      ], 
      "expiredGeofenceGeometryId":[   
      ], 
      "invalidPeriodGeofenceGeometryId":[   
      ] 
   }, 
   "type":"Microsoft.Maps.GeofenceEntered", 
   "time":"2018-11-08T00:54:17.6408601Z", 
   "specversion":"1.0" 
}

L'esempio seguente illustra lo schema per GeofenceResult

{   
   "id":"451675de-a67d-4929-876c-5c2bf0b2c000", 
   "source":"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Maps/accounts/{accountName}", 
   "subject":"/spatial/geofence/udid/{udid}/id/{eventId}", 
   "data":{   
      "geometries":[   
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"1", 
            "distance":999.0, 
            "nearestLat":47.609833, 
            "nearestLon":-122.148274 
         }, 
         {   
            "deviceId":"device_1", 
            "udId":"1a13b444-4acf-32ab-ce4e-9ca4af20b169", 
            "geometryId":"2", 
            "distance":999.0, 
            "nearestLat":47.621954, 
            "nearestLon":-122.131841 
         } 
      ], 
      "expiredGeofenceGeometryId":[   
      ], 
      "invalidPeriodGeofenceGeometryId":[   
      ] 
   }, 
   "type":"Microsoft.Maps.GeofenceResult", 
   "time":"2018-11-08T00:52:08.0954283Z", 
   "specversion":"1.0" 
}

Proprietà degli eventi

Un evento ha i seguenti dati di primo livello:

Proprietà Tipo Descrizione
source string Percorso completo della risorsa alla sorgente dell'evento. Questo campo non è scrivibile. Griglia di eventi fornisce questo valore.
subject string Percorso definito dall'editore per il soggetto dell'evento.
type string Uno dei tipi di evento registrati per questa sorgente dell'evento.
time string Ora in cui viene generato l'evento in base all'ora UTC del provider.
id string Identificatore univoco per l'evento.
data oggetto Dati dell'evento di geofencing.
specversion string Versione della specifica dello schema CloudEvents.

L'oggetto dati ha le proprietà seguenti:

Proprietà Tipo Descrizione
apiCategory string Categoria API dell'evento.
apiName string Nome API dell'evento.
issues oggetto Elenca i problemi che si sono verificati durante l'elaborazione. Se vengono restituiti problemi, non verranno restituite geometrie con la risposta.
responseCode numero Codice di risposta HTTP
geometries oggetto Elenca le geometrie di recinzione che contengono la posizione delle coordinate o si sovrappongono al searchBuffer attorno alla posizione.

L'oggetto errore viene restituito quando si verifica un errore nell'API Mappe. L'oggetto error ha le proprietà seguenti:

Proprietà Tipo Descrizione
error ErrorDetails Questo oggetto viene restituito quando si verifica un errore nell'API Maps

L'oggetto ErrorDetails viene restituito quando si verifica un errore nell'API Mappe. L'oggetto ErrorDetails o ha le proprietà seguenti:

Proprietà Tipo Descrizione
code string Codice di stato HTTP.
message string Se disponibile, una descrizione leggibile dell'errore.
innererror InnerError Se disponibile, un oggetto contenente informazioni specifiche del servizio sull'errore.

InnerError è un oggetto contenente informazioni specifiche del servizio sull'errore. L'oggetto InnerError ha le proprietà seguenti:

Proprietà Tipo Descrizione
code string Messaggio di errore.

L'oggetto geometrie elenca gli ID geometria dei recinti virtuali scaduti rispetto all'ora utente nella richiesta. L'oggetto geometrie ha elementi geometry con le proprietà seguenti:

Proprietà Tipo Descrizione
deviceid string ID del dispositivo.
distance string

Distanza dalla coordinata al bordo più vicino del recinto virtuale. Positivo indica che la coordinata è esterna al recinto virtuale. Se la coordinata si trova all'esterno del recinto virtuale, ma più del valore di searchBuffer lontano dal bordo del recinto virtuale più vicino, il valore è 999. Negativo indica che la coordinata si trova all'interno del recinto virtuale. Se la coordinata si trova all'interno del poligono, ma a una distanza superiore al valore di searchBuffer dal bordo del recinto virtuale più vicino, il valore è -999. Un valore pari a 999 indica che la coordinata è ben esterna al recinto virtuale. Un valore di -999 indica che la coordinata è molto affidabile all'interno del recinto virtuale.
geometryid string L'ID univoco identifica la geometria del recinto virtuale.
nearestlat numero Latitudine del punto più vicino della geometria.
nearestlon numero Longitudine del punto più vicino della geometria.
udId string ID univoco restituito dal servizio di caricamento dell'utente durante il caricamento di un recinto virtuale. Non verrà incluso nell'API post recinto virtuale.

L'oggetto dati ha le proprietà seguenti:

Proprietà Tipo Descrizione
expiredGeofenceGeometryId string[] Elenchi dell'ID geometry del recinto virtuale scaduto rispetto all'ora utente nella richiesta.
geometries geometrie[] Elenca le geometrie di recinzione che contengono la posizione delle coordinate o si sovrappongono al searchBuffer attorno alla posizione.
invalidPeriodGeofenceGeometryId string[] Elenchi dell'ID geometry del recinto virtuale in un periodo non valido rispetto all'ora utente nella richiesta.
isEventPublished boolean True se almeno un evento viene pubblicato nel sottoscrittore dell'evento di Mappe di Azure, false se non viene pubblicato alcun evento nel sottoscrittore dell'evento di Mappe di Azure.

Tutorial e guide

Titolo Descrizione
Reagire agli eventi di Mappe di Azure usando Griglia di eventi Panoramica dell'integrazione di Mappe di Azure con Griglia di eventi.
Esercitazione: Configurare un recinto virtuale Questa esercitazione illustra i passaggi di base per configurare il recinto virtuale usando Mappe di Azure. Si usa Griglia di eventi di Azure per trasmettere i risultati del recinto virtuale e configurare una notifica in base ai risultati del recinto virtuale.

Passaggi successivi

  • Last updated on