Share via

Event Grid kaynağı olarak Azure Haritalar

  • Makale

Bu makalede, Azure Haritalar olayları için özellikler ve şema sağlanır. Olay şemalarına giriş için bkz . Azure Event Grid olay şeması. Ayrıca, Azure Haritalar olay kaynağı olarak kullanmak için hızlı başlangıçların ve öğreticilerin listesini de sunar.

Kullanılabilir olay türleri

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

Olay türü Açıklama
Microsoft. Haritalar. GeofenceEntered Alınan koordinatlar belirli bir coğrafi konumun dışından içine taşındığında tetiklenen
Microsoft. Haritalar. GeofenceExited Alınan koordinatlar belirli bir coğrafi bölge içinden dışarıya taşındığında oluşturulur
Microsoft. Haritalar. GeofenceResult Durum ne olursa olsun, bir coğrafi sınırlama sorgusu her sonuç döndürdüğünde tetikleniyor

Örnek olaylar

Aşağıdaki örnekte GeofenceEntered olayının şeması gösterilmektedir

{   
   "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" 
}

Aşağıdaki örnekte GeofenceResult şeması gösterilmektedir

{   
   "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" 
}

Olay özellikleri

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

Özellik Türü Veri Akışı Açıklaması
source Dize Olay kaynağının tam kaynak yolu. Bu alan yazılabilir değil. Event Grid bu değeri sağlar.
subject Dize Olay konusunun yayımcı tarafından tanımlanan yolu.
type Dize Bu olay kaynağı için kayıtlı olay türlerinden biri.
time Dize Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat.
id Dize Olayın benzersiz tanımlayıcısı.
data nesne Olay verilerini coğrafi olarak sınırlama.
specversion Dize CloudEvents şema belirtimi sürümü.

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

Özellik Türü Veri Akışı Açıklaması
apiCategory Dize Olayın API kategorisi.
apiName Dize Olayın API adı.
issues nesne İşleme sırasında oluşan sorunları listeler. Herhangi bir sorun döndürülürse yanıtla birlikte hiçbir geometri döndürülmeyecektir.
responseCode Numara HTTP yanıt kodu
geometries nesne Koordinat konumunu içeren veya konumun etrafındaki arama kutusuyla çakışan çit geometrilerini listeler.

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

Özellik Türü Açıklama
error ErrorDetails bu nesne, Haritalar API'sinde bir hata oluştuğunda döndürülür

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

Özellik Türü Veri Akışı Açıklaması
code Dize HTTP durum kodu.
message Dize Varsa, hatanın 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ü Veri Akışı Açıklaması
code Dize Hata iletisi.

geometries nesnesi, istekteki kullanıcı zamanına göre süresi dolmuş olan coğrafi konumların geometri kimliklerini listeler. Geometriler nesnesi, aşağıdaki özelliklere sahip geometri öğelerine sahiptir:

Özellik Türü Veri Akışı Açıklaması
deviceid Dize Cihazın kimliği.
distance Dize

Koordinattan bölge sınırının en yakın sınırına olan uzaklık. Pozitif, koordinatın coğrafi konumun dışında olduğu anlamına gelir. Koordinat, coğrafi konumun dışındaysa ancak searchBuffer değerinin en yakın bölge sınırından uzaktaysa, değer 999'dur. Negatif, koordinatın bölge içinde olduğu anlamına gelir. Koordinat çokgenin içindeyse ancak searchBuffer değerinin en yakın coğrafi sınırdan uzak olması durumunda değer -999 olur. 999 değeri, koordinatın coğrafi konumun çok dışında olduğuna dair büyük bir güven olduğu anlamına gelir. -999 değeri, koordinatın bölge içinde iyi olduğundan büyük bir güven olduğu anlamına gelir.
geometryid Dize Benzersiz kimlik, coğrafi geometriyi tanımlar.
nearestlat Numara Geometrinin en yakın noktasının enlemi.
nearestlon Numara Geometrinin en yakın noktasının boylamı.
udId Dize Coğrafi bölge karşıya yüklenirken kullanıcı yükleme hizmetinden döndürülen benzersiz kimlik. API sonrası coğrafi sınırlamaya dahil edilmeyecektir.

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

Özellik Türü Açıklama
expiredGeofenceGeometryId string[] İstekteki kullanıcı zamanına göre süresi dolan coğrafi konumun geometri kimliğinin listeleri.
geometries geometriler[] Koordinat konumunu içeren veya konumun etrafındaki arama kutusuyla çakışan çit geometrilerini listeler.
invalidPeriodGeofenceGeometryId string[] İstekteki kullanıcı zamanına göre geçersiz dönemde olan coğrafi konumun geometri kimliğinin listeleri.
isEventPublished boolean Azure Haritalar olay abonesine en az bir olay yayımlanırsa True, Azure Haritalar olay abonesine hiçbir olay yayımlanmazsa false.

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

Ünvan Açıklama
Event Grid kullanarak Azure Haritalar olaylara tepki verme Event Grid ile Azure Haritalar tümleştirmeye genel bakış.
Öğretici: Coğrafi bölge ayarlama Bu öğreticide, Azure Haritalar kullanarak coğrafi konumu ayarlamaya yönelik temel adımlarda size yol gösterilir. Azure Event Grid'i kullanarak coğrafi alan sonuçlarının akışını yapıp coğrafi konum sonuçlarını temel alan bir bildirim ayarlarsınız.

Sonraki adımlar