DDI 3.1 XML Schema Documentation (2009-10-18)
© DDI Alliance 2009 - licensed under the terms of the GNU Lesser General Public License

complexType "GeographicCoverageType"

Namespace:	ddi:reusable:3_1
Content:	complex, 5 attributes, 10 elements
Defined:	globally in reusable.xsd, see XML source
Includes:	definitions of 9 elements
Used:	at 1 location

XML Representation Summary

<...

action

("Add" | "Update" | "Delete")

xs:string

isIdentifiable

"true"

objectSource

xs:anyURI

urn

xs:anyURI

Content:

UserID*, BoundingBox?, Description*, GeographyStructureVariable?, SpatialObject?, GeographicStructureReference*, GeographicLocationReference*, SummaryDataReference*, TopLevelReference, LowestLevelReference

</...>

Content Model Elements (10):

BoundingBox, Description, GeographicLocationReference, GeographicStructureReference, GeographyStructureVariable, LowestLevelReference, SpatialObject, SummaryDataReference, TopLevelReference, UserID

All Direct / Indirect Based Elements (1):

SpatialCoverage

Known Usage Locations

As direct type of elements (1):
SpatialCoverage

Annotation

Describes the geographic coverage of the data documented in a particular DDI module.

Type Definition Detail

Type Derivation Tree

AbstractIdentifiableType

IdentifiableType (extension)

GeographicCoverageType (extension)

XML Source (w/o annotations (10); see within schema source)

<xs:complexType name="GeographicCoverageType">

<xs:complexContent>

<xs:extension base="IdentifiableType">

<xs:sequence>

<xs:element minOccurs="0" ref="BoundingBox"/>

<xs:element maxOccurs="unbounded" minOccurs="0" ref="Description"/>

<xs:element minOccurs="0" ref="GeographyStructureVariable"/>

<xs:element minOccurs="0" ref="SpatialObject"/>

<xs:element maxOccurs="unbounded" minOccurs="0" ref="GeographicStructureReference"/>

<xs:element maxOccurs="unbounded" minOccurs="0" ref="GeographicLocationReference"/>

<xs:element maxOccurs="unbounded" minOccurs="0" ref="SummaryDataReference"/>

<xs:element ref="TopLevelReference"/>

<xs:element ref="LowestLevelReference"/>

</xs:sequence>

</xs:extension>

</xs:complexContent>

</xs:complexType>

Content Element Detail (defined in this component only; 9/10)

BoundingBox

Type:

BoundingBoxType, complex content

The Bounding Box is a 'rectangle, oriented to the x and y axes, which bounds a geographic feature or a geographic dataset. It is specified by two coordinates: xmin, ymin and xmax,ymax.' [FGDC]. In the DDI, it describes the full extent of the geographic coverage, and is designed to be used by systems that search for geography by coordinates. It is compatible with the description and structure found in FGDC and other geographic metadata structures.

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" ref="BoundingBox"/>

Description

Type:

StructuredStringType, mixed content

Provides a human-readable summary of the information included in Geography and Geography Reference. It may include information on all levels of spatial coverage, in addition to the overall coverage. This field can map to Dublin Core Coverage, which does not support structured strings. Therefore, if there is intent to map to Dublin Core, the text should not be marked up with XHTML.

XML Source (w/o annotations (1); see within schema source)

<xs:element maxOccurs="unbounded" minOccurs="0" ref="Description"/>

GeographicLocationReference

Type:

ReferenceType, complex content

Contains information on the specific geographic areas defined in the dataset such as cities, countries, or states. The areas can be defined within the DDI or an external structure can be referenced.

XML Source (w/o annotations (1); see within schema source)

<xs:element maxOccurs="unbounded" minOccurs="0" ref="GeographicLocationReference"/>

GeographicStructureReference

Type:

ReferenceType, complex content

Contains information on the hierarchy of the geographic structure. The structure can be defined within the DDI or an external structure can be referenced.

XML Source (w/o annotations (1); see within schema source)

<xs:element maxOccurs="unbounded" minOccurs="0" ref="GeographicStructureReference"/>

GeographyStructureVariable

Type:

ReferenceType, complex content

References a variable describing the geographic levels available in the data such as the variable "Summary Level" in U.S. Census data. This reference is needed for assistance in programming.

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" ref="GeographyStructureVariable"/>

LowestLevelReference

Type:

LevelReferenceType, complex content

Reference to the lowest-level geography.

XML Source (w/o annotations (1); see within schema source)

<xs:element ref="LowestLevelReference"/>

SpatialObject

Type:

GeographicDescriptionCodeType, simple content

Contains information on the most discrete type of spatial representation to which data in this file can be attached (point, line, polygon, linear ring). For example, a raw data file with an address attached to each case is 'point'. When the microdata file is anonymized and the geographic information is for a state or other defined area, it is 'polygon'. Some data, such as traffic or criminal incidence data may have a street range identification or 'line', and some such as communications data have a point with a radius or 'linear ring'.

Simple Content

enumeration of xs:NMTOKEN

Enumeration:

"Point"	-	Single geographical point (e.g., an address).
"Polygon"	-	Geographic area described with a set of three or more points.
"Line"	-	Set of points describing a line.
"LinearRing"	-	An area with a defined radius (e.g., area within x miles of a specific point.)

XML Source (w/o annotations (1); see within schema source)

<xs:element minOccurs="0" ref="SpatialObject"/>

SummaryDataReference

Type:

ReferenceType, complex content

May be repeated to reference each geography (geographic level) for which there is summary data.

XML Source (w/o annotations (1); see within schema source)

<xs:element maxOccurs="unbounded" minOccurs="0" ref="SummaryDataReference"/>

TopLevelReference

Type:

LevelReferenceType, complex content

Reference to the top-level geography.

XML Source (w/o annotations (1); see within schema source)

<xs:element ref="TopLevelReference"/>

XML schema documentation generated with DocFlex/XML SDK 1.7.2 using DocFlex/XML XSDDoc 2.1.0 template set