File formats
The table below shows the file formats supported by the CPF web service for web service resources, structured input data, and structured result data. Click the ‘view’ links below to download a sample of the resource in the each file format.
The CPF requires that UTF-8 encoding be used for all text files. This includes the text in a .dbf file for a .shpz archive, unless a .cpg file is provided in the .shpz archive.
File Extension | Media Type | Web Service | Input | Result | Description |
---|---|---|---|---|---|
csv | text/csv | view |
view |
A Comma-Separated Values file with a header line containing the field labels and one line for each feature record. | |
dbf | application/dbf | view |
view |
A DBase file containing the attribution. Each feature record is one record in the DBase file. |
|
geojson | application/vnd.geo+json (was application/x-geo+json) |
view |
GeoJSON is a geospatial data interchange format based on JavaScript Object Notation (JSON). GeoJSON can be used to create web browser based GIS applications in JavaScript. Each feature record is one feature object in a feature collection object. If there is only one record the feature object will not be wrapped in a feature collection. |
||
gml | application/gml+xml | view |
Geography Markup Language (GML) is an international standard for exchange of geographical feature maintained by the Open Geospatial Consortium (OGC). Each feature is one GML feature of the Feature Type from the 'Geomark Geometry Representations' table. The features are wrapped in a gml:FeatureCollection |
||
html | text/html | view |
A HTML document containing a table with a head section containing the field lables for each column row for each feature record. |
||
json | application/json | view |
view |
view |
JavaScript Object Notation (JSON). The geomark info is wrapped in a JSON object with one attribute for each geomark attributes. The resource links are a a JSON list with one JSON object per link. |
kml | application/vnd.google-earth.kml+xml | view |
Keyhole Markup Language (KML) is used to display geographic data in an Earth browser, such as Google Earth. KML is an international standard maintained by the Open Geospatial Consortium, Inc. (OGC). Each feature record will be encoded using a Placemark with the geomark's attributes as ExtendedData. If there are more than one record the Placemarks will be wrapped in a Document element, otherwise the Placemark will be a child of the kml element. |
||
kml | application/vnd.google-earth.kmz | view |
Keyhole Markup Language (KML) is used to display geographic data in an Earth browser, such as Google Earth. KML is an international standard maintained by the Open Geospatial Consortium, Inc. (OGC). The KMZ is a Zip file with a single kml document. Typically named doc.kml. Each feature record will be encoded using a Placemark with the geomark's attributes as ExtendedData. If there are more than one record the Placemarks will be wrapped in a Document element, otherwise the Placemark will be a child of the kml element. |
||
shpz | application/x-shp+zip | view |
view |
developed by ESRI for ArcMap which is a multi-file GIS format that ESRI Shapefile uses DBase file for the attribution and a prj file for the coordinate system. Due to the multi-file nature the shp, dbf, shx and prj files are compressed into a ZIP file for download or upload. Each feature record is one record in the ESRI shapefile. |
|
xhtml | application/xhtml+xml | view |
A XHTML document containing a table with a head section containing the field lables for each column row for each feature record. |
||
xml | text/xml | view |
view |
view |
Extensible Markup Language (XML). The geomark info is wrapped in the GeomarkInfo XML tag with one XML tag for each geomark attributes. Each resource link is contained in a resourceLink XML tag with one XML tag for each resource link attribute. |