{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-azure-maps/json-schema/microsoft-azure-maps-boundary-schema.json",
  "title": "Boundary",
  "description": "The successful response body returned by `Get Polygon`. Encoded as a\n[`GeoJSON Feature`](https://www.rfc-editor.org/rfc/rfc7946#section-3.2) whose `geometry` is\na `GeometryCollection` of one or more `Polygon` or `MultiPolygon` shapes describing the\noutline of the requested geographical area, and whose `properties` carry the area's\ndisplay name and copyright attribution.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-azure-maps-search-api-openapi.yml#/components/schemas/Boundary",
  "type": "object",
  "properties": {
    "type": {
      "$ref": "#/$defs/FeatureTypeEnum",
      "description": "The `GeoJSON` object type. Always `Feature`, as defined in\n[RFC 7946](https://www.rfc-editor.org/rfc/rfc7946)."
    },
    "geometry": {
      "$ref": "#/$defs/GeoJsonGeometryCollection",
      "description": "A `GeometryCollection` of one or more `Polygon` or `MultiPolygon` shapes whose coordinates\ndefine the outline of the requested area in WGS 84 longitude/latitude order, as defined\nby [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.8)."
    },
    "properties": {
      "$ref": "#/$defs/BoundaryProperties",
      "description": "Display name and copyright attribution for the returned area. See `BoundaryProperties`\nfor the per-property shape."
    }
  },
  "required": [
    "geometry"
  ],
  "$defs": {
    "BoundaryProperties": {
      "type": "object",
      "description": "The `properties` payload of a `Boundary`. Carries the display name of the returned\ngeographical area along with copyright attribution, both an API-wide notice and\nper-geometry data-provider credits.",
      "properties": {
        "name": {
          "type": "string",
          "description": "The display name of the geographical area, for example, `\"Bellevue\"` for a city boundary."
        },
        "copyright": {
          "type": "string",
          "description": "The Azure Maps API copyright and usage notice that applies to this response. Distinct\nfrom the per-geometry data-provider attributions in `geometriesCopyright`."
        },
        "copyrightUrl": {
          "type": "string",
          "description": "A URL to Azure Maps copyright and licensing information for the API and its underlying\ndata sources."
        },
        "geometriesCopyright": {
          "type": "array",
          "description": "Per-geometry data-provider attribution. Each entry corresponds positionally to the\nmatching shape in the parent `Boundary.geometry.geometries` array — entry `i` describes\nthe source of geometry `i`.",
          "items": {
            "$ref": "#/$defs/GeometryCopyright"
          }
        }
      }
    },
    "FeatureTypeEnum": {
      "type": "string",
      "description": "The `GeoJSON` object type for `Feature` objects. Tags each entry inside the `features`\narray of a `FeatureCollection` response (geocoding, reverse geocoding, autocomplete) and\nappears at the root of the `Get Polygon` response. The only value is `Feature`, as\ndefined in [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).",
      "enum": [
        "Feature"
      ],
      "x-ms-enum": {
        "name": "FeatureTypeEnum",
        "modelAsString": true,
        "values": [
          {
            "name": "Feature",
            "value": "Feature",
            "description": "The `GeoJSON Feature` object type. Appears on every Feature inside a `FeatureCollection`\nresponse, and at the root of the `Get Polygon` response."
          }
        ]
      }
    },
    "GeoJsonGeometry": {
      "type": "object",
      "description": "A valid `GeoJSON` geometry object. The type must be one of the seven valid\nGeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString,\nPolygon, MultiPolygon and GeometryCollection. Please refer to [RFC\n7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details.",
      "properties": {
        "type": {
          "$ref": "#/$defs/GeoJsonObjectType",
          "description": "Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object\ntypes - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon,\nGeometryCollection, Feature and FeatureCollection."
        },
        "bbox": {
          "type": "array",
          "description": "Bounding box. Projection used - EPSG:3857. Please refer to [RFC 7946](https://datatracker.ietf.org/doc/html/rfc7946#section-5) for details.",
          "minItems": 4,
          "maxItems": 4,
          "items": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "required": [
        "type"
      ]
    },
    "GeoJsonGeometryCollection": {
      "type": "object",
      "description": "A valid `GeoJSON GeometryCollection` object type. Please refer to [RFC\n7946](https://tools.ietf.org/html/rfc7946#section-3.1.8) for details.",
      "properties": {
        "geometries": {
          "type": "array",
          "description": "Contains a list of valid `GeoJSON` geometry objects. **Note** that coordinates\nin GeoJSON are in x, y order (longitude, latitude).",
          "items": {
            "$ref": "#/$defs/GeoJsonGeometry"
          }
        }
      },
      "required": [
        "geometries"
      ],
      "allOf": [
        {
          "$ref": "#/$defs/GeoJsonGeometry"
        }
      ],
      "x-ms-discriminator-value": "GeometryCollection"
    },
    "GeoJsonObjectType": {
      "type": "string",
      "description": "Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object\ntypes - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon,\nGeometryCollection, Feature and FeatureCollection.",
      "enum": [
        "Point",
        "MultiPoint",
        "LineString",
        "MultiLineString",
        "Polygon",
        "MultiPolygon",
        "GeometryCollection",
        "Feature",
        "FeatureCollection"
      ],
      "x-ms-enum": {
        "name": "GeoJsonObjectType",
        "modelAsString": false,
        "values": [
          {
            "name": "GeoJsonPoint",
            "value": "Point",
            "description": "`GeoJSON Point` geometry."
          },
          {
            "name": "GeoJsonMultiPoint",
            "value": "MultiPoint",
            "description": "`GeoJSON MultiPoint` geometry."
          },
          {
            "name": "GeoJsonLineString",
            "value": "LineString",
            "description": "`GeoJSON LineString` geometry."
          },
          {
            "name": "GeoJsonMultiLineString",
            "value": "MultiLineString",
            "description": "`GeoJSON MultiLineString` geometry."
          },
          {
            "name": "GeoJsonPolygon",
            "value": "Polygon",
            "description": "`GeoJSON Polygon` geometry."
          },
          {
            "name": "GeoJsonMultiPolygon",
            "value": "MultiPolygon",
            "description": "`GeoJSON MultiPolygon` geometry."
          },
          {
            "name": "GeoJsonGeometryCollection",
            "value": "GeometryCollection",
            "description": "`GeoJSON GeometryCollection` geometry."
          },
          {
            "name": "GeoJsonFeature",
            "value": "Feature",
            "description": "`GeoJSON Feature` object."
          },
          {
            "name": "GeoJsonFeatureCollection",
            "value": "FeatureCollection",
            "description": "`GeoJSON FeatureCollection` object."
          }
        ]
      }
    },
    "GeometryCopyright": {
      "type": "object",
      "description": "A single per-geometry data-provider attribution entry within\n`BoundaryProperties.geometriesCopyright`. Identifies the source of one geometry in\nthe parent `Boundary.geometry.geometries` array.",
      "properties": {
        "sourceName": {
          "type": "string",
          "description": "An identifier for the data provider that supplied this geometry."
        },
        "copyright": {
          "type": "string",
          "description": "The human-readable attribution string for the data provider. For example, `\"TomTom\"`.\nMay be a vendor name or a fuller copyright notice."
        }
      }
    }
  }
}