Azure Maps en tant que source Event Grid

Cet article fournit les propriétés et le schéma des événements Azure Maps. Pour une présentation des schémas d’événements, consultez Schéma d’événements Azure Event Grid. Il vous donne également la liste des démarrages rapides et des didacticiels pour utiliser Azure Maps comme source d’événement.

Types d’événement disponibles

Un compte Azure Maps émet les types d’événements suivants :

Type d’événement Description
Microsoft.Maps.GeofenceEntered Déclenché lorsque les coordonnées reçues ont été déplacées de l’extérieur d’une limite géographique donnée à l’intérieur
Microsoft.Maps.GeofenceExited Déclenché lorsque les coordonnées reçues ont été déplacées d’une limite géographique donnée vers l’extérieur
Microsoft.Maps.GeofenceResult Déclenché chaque fois qu’une requête de géofencing retourne un résultat, quel que soit l’état

Exemples d'événements

L’exemple suivant montre le schéma d’un événement 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’exemple suivant montre le schéma pour 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" 
}

Propriétés d’événement

Un événement a les données de niveau supérieur suivantes :

Propriété Type Description
source ficelle Chemin complet de la ressource vers la source d’événement. Ce champ n’est pas accessible en écriture. Event Grid fournit cette valeur.
subject ficelle chemin d’accès défini par Publisher à l’objet de l’événement.
type ficelle L’un des types d’événements inscrits pour cette source d’événement.
time ficelle Heure à laquelle l’événement est généré en fonction de l’heure UTC du fournisseur.
id ficelle Identificateur unique de l’événement.
data objet Données d’événement de géofencing.
specversion ficelle Version de la spécification du schéma CloudEvents.

L’objet de données comporte les propriétés suivantes :

Propriété Type Description
apiCategory ficelle Catégorie d’API de l’événement.
apiName ficelle Nom de l’API de l’événement.
issues objet Répertorie les problèmes survenus pendant le traitement. Si des problèmes sont retournés, aucune géométrie n’est retournée avec la réponse.
responseCode nombre Code de réponse HTTP
geometries objet Répertorie les géométries de clôture qui contiennent la position des coordonnées ou qui chevauchent le searchBuffer autour de la position.

L’objet d’erreur est retourné lorsqu’une erreur se produit dans l’API Maps. L’objet d’erreur a les propriétés suivantes :

Propriété Type Description
error Détails de l'erreur Cet objet est retourné lorsqu’une erreur survient dans l’API Maps

L’objet ErrorDetails est retourné lorsqu’une erreur se produit dans l’API Maps. ErrorDetails ou l’objet a les propriétés suivantes :

Propriété Type Description
code ficelle Code d’état HTTP.
message ficelle Si elle est disponible, une description lisible par l’homme de l’erreur.
innererror InnerError S’il est disponible, un objet contenant des informations spécifiques au service sur l’erreur.

InnerError est un objet contenant des informations spécifiques au service sur l’erreur. L’objet InnerError a les propriétés suivantes :

Propriété Type Description
code ficelle Message d’erreur.

L’objet géométrie répertorie les ID géométriques des limites géographiques qui ont expiré par rapport à l’heure de l’utilisateur dans la requête. L’objet géométrie a des éléments géométriques avec les propriétés suivantes :

Propriété Type Description
deviceid ficelle ID de l’appareil.
distance ficelle

Distance entre la coordonnée et la bordure la plus proche de la limite géographique. Positif signifie que la coordonnée est en dehors de la limite géographique. Si la coordonnée se trouve en dehors de la limite géographique, mais plus que la valeur de searchBuffer loin de la bordure de limite géographique la plus proche, la valeur est 999. Négative signifie que la coordonnée se trouve à l’intérieur de la limite géographique. Si la coordonnée se trouve à l’intérieur du polygone, mais à plus de la valeur de searchBuffer à partir de la bordure de géorepérage la plus proche, la valeur est -999. Une valeur de 999 signifie qu’il y a une grande confiance que la coordonnée est bien en dehors de la limite géographique. Une valeur de -999 signifie qu’il y a une grande confiance que la coordonnée est bien dans la limite géographique.
geometryid ficelle L’ID unique identifie la géométrie de limite géographique.
nearestlat nombre Latitude du point le plus proche de la géométrie.
nearestlon nombre Longitude du point le plus proche de la géométrie.
udId ficelle ID unique retourné par le service de chargement utilisateur lors du chargement d’une limite géographique. Ne sera pas inclus dans l’API de publication de géofencing.

L’objet de données comporte les propriétés suivantes :

Propriété Type Description
expiredGeofenceGeometryId chaîne de caractères[] Répertorie l’ID geometry de la limite géographique expirée par rapport à l’heure de l’utilisateur dans la requête.
geometries géométries[] Répertorie les géométries de clôture qui contiennent la position des coordonnées ou qui chevauchent le searchBuffer autour de la position.
invalidPeriodGeofenceGeometryId chaîne de caractères[] Répertorie l’ID geometry de la limite géographique qui est en période non valide par rapport à l’heure de l’utilisateur dans la requête.
isEventPublished booléen True si au moins un événement est publié sur l’abonné aux événements Azure Maps, false si aucun événement n’est publié sur l’abonné aux événements Azure Maps.

Didacticiels et guides pratiques

Titre Description
Réagir aux événements Azure Maps à l’aide d’Event Grid Vue d’ensemble de l’intégration d’Azure Maps à Event Grid.
Tutoriel : Configurer une limite géographique Ce tutoriel vous guide tout au long des étapes de base pour configurer la limite géographique à l’aide d’Azure Maps. Vous utilisez Azure Event Grid pour diffuser en continu les résultats de la limite géographique et configurer une notification en fonction des résultats de la limite géographique.

Étapes suivantes

  • Last updated on