다음을 통해 공유

Event Grid 원본으로서의 Azure Maps

  • 아티클

이 문서에서는 Azure Maps 이벤트에 대한 속성과 스키마를 제공합니다. 이벤트 스키마에 대한 소개는 Azure Event Grid 이벤트 스키마를 참조하세요. 또한 이벤트 원본으로 Azure Maps를 사용하기 위한 빠른 시작 및 자습서의 목록을 제공합니다.

사용할 수 있는 이벤트 유형

Azure Maps 계정은 다음과 같은 이벤트 유형을 내보냅니다.

이벤트 유형 설명
Microsoft.Maps.GeofenceEntered 수신된 좌표가 지정된 지오펜스 외부에서 내부로 이동한 경우에 발생합니다.
Microsoft.Maps.GeofenceExited 수신된 좌표가 지정된 지오펜스 내부에서 외부로 이동한 경우에 발생합니다.
Microsoft.Maps.GeofenceResult 상태와 관계없이 지오펜싱 쿼리에서 결과가 반환될 때마다 발생합니다.

예제 이벤트

다음 예제에서는 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" 
}

다음 예제에서는 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" 
}

이벤트 속성

이벤트에는 다음과 같은 최상위 데이터가 있습니다.

속성 Type Description
source string 이벤트 원본에 대한 전체 리소스 경로입니다. 이 필드는 쓸 수 없습니다. Event Grid는 이 값을 제공합니다.
subject string 게시자가 정의한 이벤트 주체의 경로입니다.
type string 이 이벤트 원본에 대해 등록된 이벤트 유형 중 하나입니다.
time string 공급자의 UTC 시간을 기준으로 이벤트가 생성되는 시간입니다.
id string 이벤트에 대한 고유 식별자입니다.
data 개체 지오펜싱 이벤트 데이터입니다.
specversion string CloudEvents 스키마 사양 버전입니다.

데이터 개체의 속성은 다음과 같습니다.

속성 Type Description
apiCategory string 이벤트의 API 범주입니다.
apiName string 이벤트의 API 이름입니다.
issues 개체 처리 중에 발생한 문제를 나열합니다. 문제가 반환되면 응답과 함께 기하 도형이 반환되지 않습니다.
responseCode number HTTP 응답 코드
geometries 개체 좌표 위치를 포함하거나 위치 주위의 searchBuffer와 겹치는 펜스 기하 도형을 나열합니다.

Maps API에서 오류가 발생하면 오류 개체가 반환됩니다. 오류 개체의 속성은 다음과 같습니다.

속성 Type 설명
error ErrorDetails Maps API에서 오류가 발생하면 이 개체가 반환됩니다.

Maps API에서 오류가 발생하면 ErrorDetails 개체가 반환됩니다. ErrorDetails 또는 개체의 속성은 다음과 같습니다.

속성 Type Description
code string HTTP 상태 코드입니다.
message string 사용 가능한 경우, 사용자가 읽을 수 있는 오류 설명입니다.
innererror InnerError 사용 가능한 경우, 오류에 대한 서비스 특정 정보가 포함된 개체입니다.

InnerError는 오류에 대한 서비스 특정 정보가 포함된 개체입니다. InnerError 개체의 속성은 다음과 같습니다.

속성 Type Description
code string 오류 메시지입니다.

geometries 개체는 요청의 사용자 시간을 기준으로 만료된 지오펜스의 기하 도형 ID를 나열합니다. 기하 도형 개체에 포함된 기하 도형 항목의 속성은 다음과 같습니다.

속성 Type Description
deviceid string 디바이스의 ID입니다.
distance string

좌표에서 가장 가까운 지오펜스 경계까지의 거리입니다. 양수는 좌표가 지오펜스 외부에 있음을 의미합니다. 좌표가 지오펜스 외부에 있지만 가장 가까운 지오펜스 경계에서 searchBuffer 값보다 멀리 떨어진 경우의 값은 999입니다. 음수는 좌표가 지오펜스 내부에 있음을 의미합니다. 좌표가 다각형 내부에 있지만 가장 가까운 지오펜싱 경계에서 searchBuffer 값보다 멀리 떨어진 경우의 값은 -999입니다. 값이 999이면 좌표가 지오펜스 외부에 있다는 확신이 커집니다. 값이 -999이면 좌표가 지오펜스 내에 있다는 확신이 커집니다.
geometryid string 고유 ID는 지오펜스 기하 도형을 식별합니다.
nearestlat number 기하 도형에서 가장 가까운 지점의 위도입니다.
nearestlon number 기하 도형에서 가장 가까운 지점의 경도입니다.
udId string 지오펜스를 업로드할 때 사용자 업로드 서비스에서 반환되는 고유 ID입니다. 지오펜싱 POST API에는 포함되지 않습니다.

데이터 개체의 속성은 다음과 같습니다.

속성 Type 설명
expiredGeofenceGeometryId string[] 요청의 사용자 시간을 기준으로, 만료된 지오펜스의 기하 도형 ID 목록입니다.
geometries geometries[] 좌표 위치를 포함하거나 위치 주위의 searchBuffer와 겹치는 펜스 기하 도형을 나열합니다.
invalidPeriodGeofenceGeometryId string[] 요청의 사용자 시간을 기준으로, 잘못된 기간에 있는 지오펜스의 기하 도형 ID 목록입니다.
isEventPublished 부울 값 하나 이상의 이벤트가 Azure Maps 이벤트 구독자에 게시된 경우에는 true이고, Azure Maps 이벤트 구독자에 이벤트가 게시되지 않은 경우에는 false입니다.

자습서 및 방법

제목 설명
Event Grid를 사용하여 Azure Maps 이벤트에 대응 Event Grid와 Azure Maps 통합에 관한 개요입니다.
자습서: 오펜스 설정 이 자습서에서는 Azure Maps를 사용하여 지오펜스를 설정하는 기본 단계를 안내합니다. Azure Event Grid를 사용하여 지오펜스 결과를 스트림하고, 지오펜스 결과를 기반으로 하는 알림을 설정합니다.

다음 단계