확장된 GeoJSON 기하 도형

  • 아티클

Azure Maps는 지리적 기능에 따라 내부를 검색할 수 있는 강력한 API 목록을 제공됩니다. 이러한 API는 지리적 기능을 대표하는 표준 GeoJSON 사양을 준수합니다.

GeoJSON 사양에서 지원하는 기하 도형은 다음으로 제한됩니다.

  • GeometryCollection
  • LineString
  • MultiLineString
  • 다중 포인트
  • MultiPolygon
  • Point
  • Polygon

일부 Azure Maps API는 GeoJSON 사양의 일부가 아닌 기하 도형을 수락합니다. 예를 들어 기하 도형 내에서 검색 API는 원과 다각형을 허용합니다.

이 문서에서는 Azure Maps가 GeoJSON 사양을 확장하여 특정 기하 도형을 나타내는 방법에 대한 자세한 설명을 제공합니다.

원

GeoJSON 사양은 Circle 기하 도형을 지원하지 않습니다. GeoJSON Point Feature 개체는 원을 나타내는 데 사용됩니다.

GeoJSON Feature 개체를 사용하여 표현된 Circle 기하 도형은 다음 좌표와 속성을 반드시 포함해야 합니다.

좌표 속성
가운데 맞춤 원의 중심은 GeoJSON Point 개체를 사용하여 표현합니다.
반경 원의 radius는 GeoJSON Feature의 속성을 사용하여 표현됩니다. 반지름 값은 미터(meters) 단위이고 double 형식이어야 합니다.
SubType 원 기하 도형에는 subType 속성도 포함되어야 합니다. 이 속성은 GeoJSON Feature의 속성의 한 부분이어야 하며 해당 값은 원이어야 합니다

원 예제

GeoJSON Feature 개체를 사용하여 원을 표시하는 방법은 다음과 같습니다. 위도: 47.639754 및 경도:-122.126986 지점을 원의 중심으로 지정하고 반지름을 100미터로 할당하겠습니다.

{
    "type": "Feature",
    "geometry": {
        "type": "Point",
        "coordinates": [-122.126986, 47.639754]
    },
    "properties": {
        "subType": "Circle",
        "radius": 100
    }
}

사각형

GeoJSON 사양은 Rectangle 기하 도형을 지원하지 않습니다. GeoJSON Polygon Feature 개체는 사각형을 나타내는 데 사용됩니다. 사각형 확장은 웹 SDK의 그리기 도구 모듈에서 주로 사용됩니다.

GeoJSON Polygon Feature 개체를 사용하여 표현된 Rectangle 기하 도형은 다음 좌표와 속성을 반드시 포함해야 합니다.

좌표 속성
모퉁이 사각형의 모퉁이는 GeoJSON Polygon 개체의 좌표를 사용하여 표시 됩니다. 각 모퉁이마다 하나씩, 5개의 좌표가 있어야 합니다. 그리고 첫 번째 좌표와 동일한 다섯 번째 좌표로 다각형 링을 닫습니다. 이러한 좌표의 정렬을 맞추고 개발자가 원하는 대로 회전할 수 있다고 가정합니다.
SubType 사각형 기하 도형 또한 subType 속성을 포함해야 합니다. 이 속성은 GeoJSON Feature 속성의 한 부분이어야 하며, 해당 값은 사각형이어야 합니다

사각형 예제

{
    "type": "Feature",
    "geometry": {
        "type": "Polygon",
        "coordinates": [[[5,25],[14,25],[14,29],[5,29],[5,25]]]
    },
    "properties": {
        "subType": "Rectangle"
    }
}

다음 단계

Azure Maps에서 GeoJSON 데이터에 대해 자세히 알아보세요.

지오펜스 GeoJSON 형식

Azure Maps 및 위치 인텔리전스 애플리케이션과 관련된 일반적인 기술 용어를 검토합니다.

Azure Maps 용어집