Azure Haritalar Event Grid kaynak olarak

Özellik Tür Description
deviceid dize Cihazın KIMLIĞI.
distance string

Koordinatlardan bölge alanının en yakın kenarlığına olan uzaklık. Pozitif, koordinat bölge sayısının dışında olduğu anlamına gelir. Koordinat Bölge sınırının dışında, ancak en yakın bölge genişliğinden daha fazla searchBuffer değeri varsa, değer 999 ' dir. Negatif, koordinat bölge sayısının içinde olduğu anlamına gelir. Koordinat Çokgen içindeyse, ancak en yakın bölge sınırlaması kenarından daha fazla searchBuffer değerinden fazla olursa değer-999 olur. 999 değeri, koordinat bölge alanının dışında iyi bir güvenilirlik olduğu anlamına gelir. -999 değeri, koordinatın bölge kapsamında iyi olduğu anlamına gelir.

geometryid string Benzersiz kimlik, bölge sınırı geometrisini tanımlar.
nearestlat sayı En yakın geometri noktası enlem.
nearestlon sayı Geometri 'nın en yakın noktasının boylam.
udId string Bölge, karşıya yüklenirken Kullanıcı karşıya yükleme hizmetinden döndürülen benzersiz KIMLIK. Bölge sınırlaması Post API 'sine dahil değildir.

Veri nesnesi aşağıdaki özelliklere sahiptir:

Özellik Tür Description
expiredGeofenceGeometryId String [] İstekteki Kullanıcı saatine göre süresi dolmak üzere olan bölge sınırı 'ın geometri kimliği listesi.
geometries geometriler [] Koordinat konumunu içeren sınır geometrileri listeler veya konumun çevresindeki searchBuffer ile çakışıyor.
invalidPeriodGeofenceGeometryId String [] İstekteki Kullanıcı saatine göre geçersiz süre içinde olan bölge sınırı 'ın geometri kimliği listesi.
isEventPublished boolean azure Haritalar olay abonesi 'nda en az bir olay yayımlanıyorsa True, azure Haritalar olay abonesi 'nda hiçbir olay yayımlanmamışsa false.

Öğreticiler ve nasıl yapılır kılavuzları

Başlık Açıklama
Event Grid kullanarak Azure Haritalar olaylarına React Azure Haritalar Event Grid ile tümleştirmeyle ilgili genel bakış.
Öğretici: bölge kümesi ayarlama bu öğretici, Azure Haritalar kullanarak bölge sınırlaması ayarlamak için temel adımlarda size yol gösterir. Bölge sonuçlarının akışını yapmak ve bölge sonuçlarına dayalı bir bildirim ayarlamak için Azure Event Grid kullanırsınız.

Sonraki adımlar

bu makalede, Azure Haritalar olayları için özellikler ve şema sağlanmaktadır. Olay şemalarına giriş için bkz. Azure Event Grid olay şeması. ayrıca, Azure Haritalar bir olay kaynağı olarak kullanmak için hızlı başlayan ve öğreticilerin bir listesini de sağlar.

Kullanılabilir olay türleri

Azure Haritalar hesabı aşağıdaki olay türlerini yayar:

Olay türü Açıklama
MICROSOFT. Haritalar. Bölge girildi Alınan Koordinatlar, belirli bir bölge sınırı 'ın içinden içine arasında taşındığında tetiklenir
MICROSOFT. Haritalar. Bölge, çıkış yaptı Alınan koordinatlar belirli bir bölge içinden dışarıya taşındığında tetiklenir
MICROSOFT. Haritalar. GeofenceResult Bölge sınırlama sorgusu, durumdan bağımsız olarak bir sonuç döndürdüğünde tetiklenir

Örnek olaylar

Aşağıdaki örnek, Geofencegirildi olayının şemasını gösterir

{   
   "id":"7f8446e2-1ac7-4234-8425-303726ea3981", 
   "topic":"/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":[   
      ] 
   }, 
   "eventType":"Microsoft.Maps.GeofenceEntered", 
   "eventTime":"2018-11-08T00:54:17.6408601Z", 
   "metadataVersion":"1", 
   "dataVersion":"1.0" 
}

Aşağıdaki örnek GeofenceResult için şemayı gösterir

{   
   "id":"451675de-a67d-4929-876c-5c2bf0b2c000", 
   "topic":"/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":[   
      ] 
   }, 
   "eventType":"Microsoft.Maps.GeofenceResult", 
   "eventTime":"2018-11-08T00:52:08.0954283Z", 
   "metadataVersion":"1", 
   "dataVersion":"1.0" 
}

Olay özellikleri

Bir olay aşağıdaki en üst düzey verilere sahiptir:

Özellik Tür Description
topic dize Olay kaynağının tam kaynak yolu. Bu alan yazılabilir değil. Event Grid bu değeri sağlar.
subject string Olay konusunun yayımcı tarafından tanımlanan yolu.
eventType string Bu olay kaynağı için kayıtlı olay türlerinden biri.
eventTime string Etkinliğin UTC saatine göre oluşturulduğu zaman.
id string Etkinliğin benzersiz tanımlayıcısı.
data object Bölge sınırlaması olay verileri.
dataVersion string Veri nesnesinin şema sürümü. Şema sürümünü yayımcı tanımlar.
metadataVersion string Olay meta verilerinin şema sürümü. Event Grid en üst düzey özelliklerin şemasını tanımlar. Event Grid bu değeri sağlar.

Veri nesnesi aşağıdaki özelliklere sahiptir:

Özellik Tür Description
apiCategory dize Olayın API kategorisi.
apiName string Olayın API adı.
issues object İşleme sırasında karşılaşılan sorunları listeler. Herhangi bir sorun döndürülürse yanıtla birlikte hiçbir geometri döndürülecek değildir.
responseCode sayı HTTP yanıt kodu
geometries object Koordinat konumunu içeren çit geometrilerini listeler veya konumun etrafında searchBuffer ile çakışır.

Haritalar API'sinde hata oluştuğunda hata Haritalar döndürülür. Hata nesnesi aşağıdaki özelliklere sahiptir:

Özellik Tür Description
error ErrorDetails Bu nesne, Haritalar API'sinde hata oluştuğunda döndürülür

Haritalar API'sinde hata oluştuğunda ErrorDetails nesnesi döndürülür. ErrorDetails veya nesnesi aşağıdaki özelliklere sahiptir:

Özellik Tür Description
code dize HTTP durum kodu.
message string Varsa, hatanın insanlar tarafından okunabilir bir açıklaması.
innererror InnerError Varsa, hata hakkında hizmete özgü bilgiler içeren bir nesne.

InnerError, hata hakkında hizmete özgü bilgiler içeren bir nesnedir. InnerError nesnesi aşağıdaki özelliklere sahiptir:

Özellik Tür Description
code dize Hata iletisi.

Geometriler nesnesi, istekte kullanıcı süresine göre süresi dolmuş olan bölge bölgelerinin geometri kimliklerini listeler. Geometriler nesnesi, aşağıdaki özelliklere sahip geometri öğelerine sahiptir: