GeoServer Feature Types
A feature type is a vector based spatial resource or data set that originates from a data store. In some cases, such as with a shapefile, a feature type has a one-to-one relationship with its data store. In other cases, such as PostGIS, the relationship of feature type to data store is many-to-one, feature types corresponding to a table in the database.
Version: 1.0.0
BasePath:/geoserver/rest
All rights reserved
http://apache.org/licenses/LICENSE-2.0.html
Access
- HTTP Basic Authentication
[ Jump to Models ]
Table of Contents
Up
delete /workspaces/{workspaceName}/datastores/{storeName}/featuretypes/{featureTypeName}
(deleteFeatureType)
Delete a feature type (optionally recursively deleting layers).
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
storeName (required)
Path Parameter — The name of the datastore
featureTypeName (required)
Path Parameter — The name of the feature type
Query parameters
recurse (optional)
Query Parameter — Recursively deletes all layers referenced by the specified featuretype. Allowed values for this parameter are true or false. The default value is false. A request with 'recurse=false' will fail if any layers reference the featuretype. default: false
Responses
200
The feature type was successfully deleted.
Up
delete /workspaces/{workspaceName}/featuretypes/{featureTypeName}
(deleteFeatureType_1)
Delete a feature type in the default data store for the workspace (optionally recursively deleting layers).
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
featureTypeName (required)
Path Parameter — The name of the feature type
Query parameters
recurse (optional)
Query Parameter — Recursively deletes all layers referenced by the specified featuretype. Allowed values for this parameter are true or false. The default value is false. A request with 'recurse=false' will fail if any layers reference the featuretype. default: false
Responses
200
The feature type was successfully deleted.
Up
delete /workspaces/{workspaceName}/datastores/{storeName}/featuretypes
(deleteFeatureTypes)
Invalid.
Responses
405
Method not allowed.
Up
delete /workspaces/{workspaceName}/featuretypes
(deleteFeatureTypes_2)
Invalid.
Responses
405
Method not allowed.
Up
get /workspaces/{workspaceName}/datastores/{storeName}/featuretypes/{featureTypeName}
(getFeatureType)
Get an individual feature type
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
storeName (required)
Path Parameter — The name of the datastore
featureTypeName (required)
Path Parameter — The name of the feature type
Query parameters
quietOnNotFound (optional)
Query Parameter — Prevents logging an Exception when the feature type is not present. Note that 404 status code will be returned anyway. Defaults to "false". default: false
Return type
Example data
Content-Type: application/json
"{ \"name\": \"poi\",\n \"nativeName\": \"poi\",\n \"namespace\": {\n \"name\": \"tiger\",\n \"href\": \"http://localhost:8080/geoserver/rest/namespaces/tiger.json\"\n },\n \"title\": \"Manhattan (NY) points of interest\",\n \"abstract\": \"Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.\",\n \"keywords\": {\n \"string\": [\n \"poi\",\n \"Manhattan\",\n \"DS_poi\",\n \"points_of_interest\",\n \"sampleKeyword\\\\@language=ab\\\\;\",\n \"area of effect\\\\@language=bg\\\\;\\\\@vocabulary=technical\\\\;\",\n \"Привет\\\\@language=ru\\\\;\\\\@vocabulary=friendly\\\\;\"\n ]\n },\n \"metadataLinks\": {\n \"metadataLink\": [\n {\n \"type\": \"text/plain\",\n \"metadataType\": \"FGDC\",\n \"content\": \"www.google.com\"\n }\n ]\n },\n \"dataLinks\": {\n \"org.geoserver.catalog.impl.DataLinkInfoImpl\": [\n {\n \"type\": \"text/plain\",\n \"content\": \"http://www.google.com\"\n }\n ]\n }, \n \"nativeCRS\": \"GEOGCS[\\\"WGS 84\\\", \\n DATUM[\\\"World Geodetic System 1984\\\", \\n SPHEROID[\\\"WGS 84\\\", 6378137.0, 298.257223563, AUTHORITY[\\\"EPSG\\\",\\\"7030\\\"]], \\n AUTHORITY[\\\"EPSG\\\",\\\"6326\\\"]], \\n PRIMEM[\\\"Greenwich\\\", 0.0, AUTHORITY[\\\"EPSG\\\",\\\"8901\\\"]], \\n UNIT[\\\"degree\\\", 0.017453292519943295], \\n AXIS[\\\"Geodetic longitude\\\", EAST], \\n AXIS[\\\"Geodetic latitude\\\", NORTH], \\n AUTHORITY[\\\"EPSG\\\",\\\"4326\\\"]]\",\n \"srs\": \"EPSG:4326\",\n \"nativeBoundingBox\": {\n \"minx\": -74.0118315772888,\n \"maxx\": -74.00153046439813,\n \"miny\": 40.70754683896324,\n \"maxy\": 40.719885123828675,\n \"crs\": \"EPSG:4326\"\n },\n \"latLonBoundingBox\": {\n \"minx\": -74.0118315772888,\n \"maxx\": -74.00857344353275,\n \"miny\": 40.70754683896324,\n \"maxy\": 40.711945649065406,\n \"crs\": \"EPSG:4326\"\n },\n \"projectionPolicy\": \"REPROJECT_TO_DECLARED\",\n \"enabled\": true,\n \"metadata\": {\n \"entry\": [\n {\n \"@key\": \"kml.regionateStrategy\",\n \"$\": \"external-sorting\"\n },\n {\n \"@key\": \"kml.regionateFeatureLimit\",\n \"$\": \"15\"\n },\n {\n \"@key\": \"cacheAgeMax\",\n \"$\": \"3000\"\n },\n {\n \"@key\": \"cachingEnabled\",\n \"$\": \"true\"\n },\n {\n \"@key\": \"kml.regionateAttribute\",\n \"$\": \"NAME\"\n },\n {\n \"@key\": \"indexingEnabled\",\n \"$\": \"false\"\n },\n {\n \"@key\": \"dirName\",\n \"$\": \"DS_poi_poi\"\n }\n ]\n },\n \"store\": {\n \"@class\": \"dataStore\",\n \"name\": \"tiger:nyc\",\n \"href\": \"http://localhost:8080/geoserver/rest/workspaces/tiger/datastores/nyc.json\"\n },\n \"cqlFilter\": \"INCLUDE\",\n \"maxFeatures\": 100,\n \"numDecimals\": 6,\n \"responseSRS\": {\n \"string\": [\n 4326\n ]\n },\n \"overridingServiceSRS\": true,\n \"skipNumberMatched\": true,\n \"circularArcPresent\": true,\n \"linearizationTolerance\": 10,\n \"attributes\": {\n \"attribute\": [\n {\n \"name\": \"the_geom\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"org.locationtech.jts.geom.Point\"\n },\n {\n \"name\": \"NAME\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"java.lang.String\",\n \"length\": 6\n },\n {\n \"name\": \"THUMBNAIL\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"java.lang.String\",\n \"length\": 20\n },\n {\n \"name\": \"MAINPAGE\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"java.lang.String\",\n \"length\": 19\n }\n ]\n } \n}\n"
Example data
Content-Type: application/xml
"\n poi\n poi\n \n tiger\n \n \n Manhattan (NY) points of interest\n Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.\n \n poi\n Manhattan\n DS_poi\n points_of_interest\n fred\\@language=ab\\;\n area of effect\\@language=bg\\;\\@vocabulary=Technical\\;\n Привет\\@language=ru\\;\\@vocabulary=Friendly\\;\n \n \n \n text/plain\n FGDC\n http://www.google.com\n \n \n \n \n text/plain\n http://www.google.com\n \n \n GEOGCS[\"WGS 84\", DATUM[\"World Geodetic System 1984\", SPHEROID[\"WGS 84\", 6378137.0, 298.257223563, AUTHORITY[\"EPSG\",\"7030\"]], AUTHORITY[\"EPSG\",\"6326\"]], PRIMEM[\"Greenwich\", 0.0, AUTHORITY[\"EPSG\",\"8901\"]], UNIT[\"degree\", 0.017453292519943295], AXIS[\"Geodetic longitude\", EAST], AXIS[\"Geodetic latitude\", NORTH], AUTHORITY[\"EPSG\",\"4326\"]]\n EPSG:4326\n \n -74.0118315772888\n -74.00153046439813\n 40.70754683896324\n 40.719885123828675\n EPSG:4326\n \n \n -74.0118315772888\n -74.00857344353275\n 40.70754683896324\n 40.711945649065406\n EPSG:4326\n \n NONE\n true\n \n external-sorting\n \n \n false\n \n \n 15\n 3000\n \n \n false\n \n \n \n true\n NAME\n false\n DS_poi_poi\n \n \n tiger:nyc\n \n \n INCLUDE\n 100\n 6\n \n 4326\n \n true\n true\n true\n 10\n \n \n the_geom\n 0\n 1\n true\n org.locationtech.jts.geom.Point\n \n \n NAME\n 0\n 1\n true\n java.lang.String\n 6\n \n \n THUMBNAIL\n 0\n 1\n true\n java.lang.String\n 20\n \n \n MAINPAGE\n 0\n 1\n true\n java.lang.String\n 19\n \n \n\n"
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
text/html
application/xml
application/json
Responses
200
Successful response containing feature type.
inline_response_200_1
Example data
Content-Type: application/json
{ "name": "poi",
"nativeName": "poi",
"namespace": {
"name": "tiger",
"href": "http://localhost:8080/geoserver/rest/namespaces/tiger.json"
},
"title": "Manhattan (NY) points of interest",
"abstract": "Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.",
"keywords": {
"string": [
"poi",
"Manhattan",
"DS_poi",
"points_of_interest",
"sampleKeyword\\@language=ab\\;",
"area of effect\\@language=bg\\;\\@vocabulary=technical\\;",
"Привет\\@language=ru\\;\\@vocabulary=friendly\\;"
]
},
"metadataLinks": {
"metadataLink": [
{
"type": "text/plain",
"metadataType": "FGDC",
"content": "www.google.com"
}
]
},
"dataLinks": {
"org.geoserver.catalog.impl.DataLinkInfoImpl": [
{
"type": "text/plain",
"content": "http://www.google.com"
}
]
},
"nativeCRS": "GEOGCS[\"WGS 84\", \n DATUM[\"World Geodetic System 1984\", \n SPHEROID[\"WGS 84\", 6378137.0, 298.257223563, AUTHORITY[\"EPSG\",\"7030\"]], \n AUTHORITY[\"EPSG\",\"6326\"]], \n PRIMEM[\"Greenwich\", 0.0, AUTHORITY[\"EPSG\",\"8901\"]], \n UNIT[\"degree\", 0.017453292519943295], \n AXIS[\"Geodetic longitude\", EAST], \n AXIS[\"Geodetic latitude\", NORTH], \n AUTHORITY[\"EPSG\",\"4326\"]]",
"srs": "EPSG:4326",
"nativeBoundingBox": {
"minx": -74.0118315772888,
"maxx": -74.00153046439813,
"miny": 40.70754683896324,
"maxy": 40.719885123828675,
"crs": "EPSG:4326"
},
"latLonBoundingBox": {
"minx": -74.0118315772888,
"maxx": -74.00857344353275,
"miny": 40.70754683896324,
"maxy": 40.711945649065406,
"crs": "EPSG:4326"
},
"projectionPolicy": "REPROJECT_TO_DECLARED",
"enabled": true,
"metadata": {
"entry": [
{
"@key": "kml.regionateStrategy",
"$": "external-sorting"
},
{
"@key": "kml.regionateFeatureLimit",
"$": "15"
},
{
"@key": "cacheAgeMax",
"$": "3000"
},
{
"@key": "cachingEnabled",
"$": "true"
},
{
"@key": "kml.regionateAttribute",
"$": "NAME"
},
{
"@key": "indexingEnabled",
"$": "false"
},
{
"@key": "dirName",
"$": "DS_poi_poi"
}
]
},
"store": {
"@class": "dataStore",
"name": "tiger:nyc",
"href": "http://localhost:8080/geoserver/rest/workspaces/tiger/datastores/nyc.json"
},
"cqlFilter": "INCLUDE",
"maxFeatures": 100,
"numDecimals": 6,
"responseSRS": {
"string": [
4326
]
},
"overridingServiceSRS": true,
"skipNumberMatched": true,
"circularArcPresent": true,
"linearizationTolerance": 10,
"attributes": {
"attribute": [
{
"name": "the_geom",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "org.locationtech.jts.geom.Point"
},
{
"name": "NAME",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "java.lang.String",
"length": 6
},
{
"name": "THUMBNAIL",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "java.lang.String",
"length": 20
},
{
"name": "MAINPAGE",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "java.lang.String",
"length": 19
}
]
}
}
Example data
Content-Type: application/xml
poi
poi
tiger
Manhattan (NY) points of interest
Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.
poi
Manhattan
DS_poi
points_of_interest
fred\@language=ab\;
area of effect\@language=bg\;\@vocabulary=Technical\;
Привет\@language=ru\;\@vocabulary=Friendly\;
text/plain
FGDC
http://www.google.com
text/plain
http://www.google.com
GEOGCS["WGS 84", DATUM["World Geodetic System 1984", SPHEROID["WGS 84", 6378137.0, 298.257223563, AUTHORITY["EPSG","7030"]], AUTHORITY["EPSG","6326"]], PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]], UNIT["degree", 0.017453292519943295], AXIS["Geodetic longitude", EAST], AXIS["Geodetic latitude", NORTH], AUTHORITY["EPSG","4326"]]
EPSG:4326
-74.0118315772888
-74.00153046439813
40.70754683896324
40.719885123828675
EPSG:4326
-74.0118315772888
-74.00857344353275
40.70754683896324
40.711945649065406
EPSG:4326
NONE
true
external-sorting
false
15
3000
false
true
NAME
false
DS_poi_poi
tiger:nyc
INCLUDE
100
6
4326
true
true
true
10
the_geom
0
1
true
org.locationtech.jts.geom.Point
NAME
0
1
true
java.lang.String
6
THUMBNAIL
0
1
true
java.lang.String
20
MAINPAGE
0
1
true
java.lang.String
19
Up
get /workspaces/{workspaceName}/featuretypes/{featureTypeName}
(getFeatureType_3)
Get an individual feature type in the default data store for the workspace
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
featureTypeName (required)
Path Parameter — The name of the feature type
Query parameters
quietOnNotFound (optional)
Query Parameter — Prevents logging an Exception when the feature type is not present. Note that 404 status code will be returned anyway. Defaults to "false". default: false
Return type
Example data
Content-Type: application/json
"{ \"name\": \"poi\",\n \"nativeName\": \"poi\",\n \"namespace\": {\n \"name\": \"tiger\",\n \"href\": \"http://localhost:8080/geoserver/rest/namespaces/tiger.json\"\n },\n \"title\": \"Manhattan (NY) points of interest\",\n \"abstract\": \"Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.\",\n \"keywords\": {\n \"string\": [\n \"poi\",\n \"Manhattan\",\n \"DS_poi\",\n \"points_of_interest\",\n \"sampleKeyword\\\\@language=ab\\\\;\",\n \"area of effect\\\\@language=bg\\\\;\\\\@vocabulary=technical\\\\;\",\n \"Привет\\\\@language=ru\\\\;\\\\@vocabulary=friendly\\\\;\"\n ]\n },\n \"metadataLinks\": {\n \"metadataLink\": [\n {\n \"type\": \"text/plain\",\n \"metadataType\": \"FGDC\",\n \"content\": \"www.google.com\"\n }\n ]\n },\n \"dataLinks\": {\n \"org.geoserver.catalog.impl.DataLinkInfoImpl\": [\n {\n \"type\": \"text/plain\",\n \"content\": \"http://www.google.com\"\n }\n ]\n }, \n \"nativeCRS\": \"GEOGCS[\\\"WGS 84\\\", \\n DATUM[\\\"World Geodetic System 1984\\\", \\n SPHEROID[\\\"WGS 84\\\", 6378137.0, 298.257223563, AUTHORITY[\\\"EPSG\\\",\\\"7030\\\"]], \\n AUTHORITY[\\\"EPSG\\\",\\\"6326\\\"]], \\n PRIMEM[\\\"Greenwich\\\", 0.0, AUTHORITY[\\\"EPSG\\\",\\\"8901\\\"]], \\n UNIT[\\\"degree\\\", 0.017453292519943295], \\n AXIS[\\\"Geodetic longitude\\\", EAST], \\n AXIS[\\\"Geodetic latitude\\\", NORTH], \\n AUTHORITY[\\\"EPSG\\\",\\\"4326\\\"]]\",\n \"srs\": \"EPSG:4326\",\n \"nativeBoundingBox\": {\n \"minx\": -74.0118315772888,\n \"maxx\": -74.00153046439813,\n \"miny\": 40.70754683896324,\n \"maxy\": 40.719885123828675,\n \"crs\": \"EPSG:4326\"\n },\n \"latLonBoundingBox\": {\n \"minx\": -74.0118315772888,\n \"maxx\": -74.00857344353275,\n \"miny\": 40.70754683896324,\n \"maxy\": 40.711945649065406,\n \"crs\": \"EPSG:4326\"\n },\n \"projectionPolicy\": \"REPROJECT_TO_DECLARED\",\n \"enabled\": true,\n \"metadata\": {\n \"entry\": [\n {\n \"@key\": \"kml.regionateStrategy\",\n \"$\": \"external-sorting\"\n },\n {\n \"@key\": \"kml.regionateFeatureLimit\",\n \"$\": \"15\"\n },\n {\n \"@key\": \"cacheAgeMax\",\n \"$\": \"3000\"\n },\n {\n \"@key\": \"cachingEnabled\",\n \"$\": \"true\"\n },\n {\n \"@key\": \"kml.regionateAttribute\",\n \"$\": \"NAME\"\n },\n {\n \"@key\": \"indexingEnabled\",\n \"$\": \"false\"\n },\n {\n \"@key\": \"dirName\",\n \"$\": \"DS_poi_poi\"\n }\n ]\n },\n \"store\": {\n \"@class\": \"dataStore\",\n \"name\": \"tiger:nyc\",\n \"href\": \"http://localhost:8080/geoserver/rest/workspaces/tiger/datastores/nyc.json\"\n },\n \"cqlFilter\": \"INCLUDE\",\n \"maxFeatures\": 100,\n \"numDecimals\": 6,\n \"responseSRS\": {\n \"string\": [\n 4326\n ]\n },\n \"overridingServiceSRS\": true,\n \"skipNumberMatched\": true,\n \"circularArcPresent\": true,\n \"linearizationTolerance\": 10,\n \"attributes\": {\n \"attribute\": [\n {\n \"name\": \"the_geom\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"org.locationtech.jts.geom.Point\"\n },\n {\n \"name\": \"NAME\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"java.lang.String\",\n \"length\": 6\n },\n {\n \"name\": \"THUMBNAIL\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"java.lang.String\",\n \"length\": 20\n },\n {\n \"name\": \"MAINPAGE\",\n \"minOccurs\": 0,\n \"maxOccurs\": 1,\n \"nillable\": true,\n \"binding\": \"java.lang.String\",\n \"length\": 19\n }\n ]\n } \n}\n"
Example data
Content-Type: application/xml
"\n poi\n poi\n \n tiger\n \n \n Manhattan (NY) points of interest\n Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.\n \n poi\n Manhattan\n DS_poi\n points_of_interest\n fred\\@language=ab\\;\n area of effect\\@language=bg\\;\\@vocabulary=Technical\\;\n Привет\\@language=ru\\;\\@vocabulary=Friendly\\;\n \n \n \n text/plain\n FGDC\n http://www.google.com\n \n \n \n \n text/plain\n http://www.google.com\n \n \n GEOGCS[\"WGS 84\", DATUM[\"World Geodetic System 1984\", SPHEROID[\"WGS 84\", 6378137.0, 298.257223563, AUTHORITY[\"EPSG\",\"7030\"]], AUTHORITY[\"EPSG\",\"6326\"]], PRIMEM[\"Greenwich\", 0.0, AUTHORITY[\"EPSG\",\"8901\"]], UNIT[\"degree\", 0.017453292519943295], AXIS[\"Geodetic longitude\", EAST], AXIS[\"Geodetic latitude\", NORTH], AUTHORITY[\"EPSG\",\"4326\"]]\n EPSG:4326\n \n -74.0118315772888\n -74.00153046439813\n 40.70754683896324\n 40.719885123828675\n EPSG:4326\n \n \n -74.0118315772888\n -74.00857344353275\n 40.70754683896324\n 40.711945649065406\n EPSG:4326\n \n NONE\n true\n \n external-sorting\n \n \n false\n \n \n 15\n 3000\n \n \n false\n \n \n \n true\n NAME\n false\n DS_poi_poi\n \n \n tiger:nyc\n \n \n INCLUDE\n 100\n 6\n \n 4326\n \n true\n true\n true\n 10\n \n \n the_geom\n 0\n 1\n true\n org.locationtech.jts.geom.Point\n \n \n NAME\n 0\n 1\n true\n java.lang.String\n 6\n \n \n THUMBNAIL\n 0\n 1\n true\n java.lang.String\n 20\n \n \n MAINPAGE\n 0\n 1\n true\n java.lang.String\n 19\n \n \n\n"
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
text/html
application/xml
application/json
Responses
200
Successful response containing feature type.
inline_response_200_1
Example data
Content-Type: application/json
{ "name": "poi",
"nativeName": "poi",
"namespace": {
"name": "tiger",
"href": "http://localhost:8080/geoserver/rest/namespaces/tiger.json"
},
"title": "Manhattan (NY) points of interest",
"abstract": "Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.",
"keywords": {
"string": [
"poi",
"Manhattan",
"DS_poi",
"points_of_interest",
"sampleKeyword\\@language=ab\\;",
"area of effect\\@language=bg\\;\\@vocabulary=technical\\;",
"Привет\\@language=ru\\;\\@vocabulary=friendly\\;"
]
},
"metadataLinks": {
"metadataLink": [
{
"type": "text/plain",
"metadataType": "FGDC",
"content": "www.google.com"
}
]
},
"dataLinks": {
"org.geoserver.catalog.impl.DataLinkInfoImpl": [
{
"type": "text/plain",
"content": "http://www.google.com"
}
]
},
"nativeCRS": "GEOGCS[\"WGS 84\", \n DATUM[\"World Geodetic System 1984\", \n SPHEROID[\"WGS 84\", 6378137.0, 298.257223563, AUTHORITY[\"EPSG\",\"7030\"]], \n AUTHORITY[\"EPSG\",\"6326\"]], \n PRIMEM[\"Greenwich\", 0.0, AUTHORITY[\"EPSG\",\"8901\"]], \n UNIT[\"degree\", 0.017453292519943295], \n AXIS[\"Geodetic longitude\", EAST], \n AXIS[\"Geodetic latitude\", NORTH], \n AUTHORITY[\"EPSG\",\"4326\"]]",
"srs": "EPSG:4326",
"nativeBoundingBox": {
"minx": -74.0118315772888,
"maxx": -74.00153046439813,
"miny": 40.70754683896324,
"maxy": 40.719885123828675,
"crs": "EPSG:4326"
},
"latLonBoundingBox": {
"minx": -74.0118315772888,
"maxx": -74.00857344353275,
"miny": 40.70754683896324,
"maxy": 40.711945649065406,
"crs": "EPSG:4326"
},
"projectionPolicy": "REPROJECT_TO_DECLARED",
"enabled": true,
"metadata": {
"entry": [
{
"@key": "kml.regionateStrategy",
"$": "external-sorting"
},
{
"@key": "kml.regionateFeatureLimit",
"$": "15"
},
{
"@key": "cacheAgeMax",
"$": "3000"
},
{
"@key": "cachingEnabled",
"$": "true"
},
{
"@key": "kml.regionateAttribute",
"$": "NAME"
},
{
"@key": "indexingEnabled",
"$": "false"
},
{
"@key": "dirName",
"$": "DS_poi_poi"
}
]
},
"store": {
"@class": "dataStore",
"name": "tiger:nyc",
"href": "http://localhost:8080/geoserver/rest/workspaces/tiger/datastores/nyc.json"
},
"cqlFilter": "INCLUDE",
"maxFeatures": 100,
"numDecimals": 6,
"responseSRS": {
"string": [
4326
]
},
"overridingServiceSRS": true,
"skipNumberMatched": true,
"circularArcPresent": true,
"linearizationTolerance": 10,
"attributes": {
"attribute": [
{
"name": "the_geom",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "org.locationtech.jts.geom.Point"
},
{
"name": "NAME",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "java.lang.String",
"length": 6
},
{
"name": "THUMBNAIL",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "java.lang.String",
"length": 20
},
{
"name": "MAINPAGE",
"minOccurs": 0,
"maxOccurs": 1,
"nillable": true,
"binding": "java.lang.String",
"length": 19
}
]
}
}
Example data
Content-Type: application/xml
poi
poi
tiger
Manhattan (NY) points of interest
Points of interest in New York, New York (on Manhattan). One of the attributes contains the name of a file with a picture of the point of interest.
poi
Manhattan
DS_poi
points_of_interest
fred\@language=ab\;
area of effect\@language=bg\;\@vocabulary=Technical\;
Привет\@language=ru\;\@vocabulary=Friendly\;
text/plain
FGDC
http://www.google.com
text/plain
http://www.google.com
GEOGCS["WGS 84", DATUM["World Geodetic System 1984", SPHEROID["WGS 84", 6378137.0, 298.257223563, AUTHORITY["EPSG","7030"]], AUTHORITY["EPSG","6326"]], PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]], UNIT["degree", 0.017453292519943295], AXIS["Geodetic longitude", EAST], AXIS["Geodetic latitude", NORTH], AUTHORITY["EPSG","4326"]]
EPSG:4326
-74.0118315772888
-74.00153046439813
40.70754683896324
40.719885123828675
EPSG:4326
-74.0118315772888
-74.00857344353275
40.70754683896324
40.711945649065406
EPSG:4326
NONE
true
external-sorting
false
15
3000
false
true
NAME
false
DS_poi_poi
tiger:nyc
INCLUDE
100
6
4326
true
true
true
10
the_geom
0
1
true
org.locationtech.jts.geom.Point
NAME
0
1
true
java.lang.String
6
THUMBNAIL
0
1
true
java.lang.String
20
MAINPAGE
0
1
true
java.lang.String
19
Up
get /workspaces/{workspaceName}/datastores/{storeName}/featuretypes
(getFeatureTypes)
Get a list of feature types for the workspace and datastore. Use the "Accept:" header to specify format or append an extension to the endpoint (example "/featuretypes.xml" for XML)
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
storeName (required)
Path Parameter — The name of the datastore
Query parameters
list (optional)
Query Parameter — The list parameter is used to control the category of feature types that are returned. Must be one of "configured", "available", "available_with_geom", "all"
Return type
Example data
Content-Type: application/json
"{\"featureTypes\": {\n \"featureType\": [\n {\n \"name\": \"PrimitiveGeoFeature\",\n \"href\": \"http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/PrimitiveGeoFeature.json\"\n },\n {\n \"name\": \"archsites\",\n \"href\": \"http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/archsites.json\"\n }\n ]\n }\n}\n"
Example data
Content-Type: application/xml
"\n \n PrimitiveGeoFeature\n \n \n \n archsites\n \n \n\n"
Example data
Content-Type: application/xml (list=available)
"\n\n pdsa\n pdsb\n
\n"
Example data
Content-Type: application/json (list=available)
"{\"list\": { \n \"string\": [\n \"pdsa\",\n \"pdsb\"\n ]\n }\n}\n"
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
text/html
application/xml
application/json
Responses
200
Successful response containing featuretype list.
inline_response_200
Example data
Content-Type: application/json
{"featureTypes": {
"featureType": [
{
"name": "PrimitiveGeoFeature",
"href": "http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/PrimitiveGeoFeature.json"
},
{
"name": "archsites",
"href": "http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/archsites.json"
}
]
}
}
Example data
Content-Type: application/xml
PrimitiveGeoFeature
archsites
Example data
Content-Type: application/xml (list=available)
pdsa
pdsb
Example data
Content-Type: application/json (list=available)
{"list": {
"string": [
"pdsa",
"pdsb"
]
}
}
Up
get /workspaces/{workspaceName}/featuretypes
(getFeatureTypes_4)
Get a list of all feature types for all datastores in the workspace. Use the "Accept:" header to specify format or append an extension to the endpoint (example "/featuretypes.xml" for XML)
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
Query parameters
list (optional)
Query Parameter — The list parameter is used to control the category of feature types that are returned. Must be one of "configured", "available", "available_with_geom", "all"
Return type
Example data
Content-Type: application/json
"{\"featureTypes\": {\n \"featureType\": [\n {\n \"name\": \"PrimitiveGeoFeature\",\n \"href\": \"http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/PrimitiveGeoFeature.json\"\n },\n {\n \"name\": \"archsites\",\n \"href\": \"http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/archsites.json\"\n }\n ]\n }\n}\n"
Example data
Content-Type: application/xml
"\n \n PrimitiveGeoFeature\n \n \n \n archsites\n \n \n\n"
Example data
Content-Type: application/xml (list=available)
"\n\n pdsa\n pdsb\n
\n"
Example data
Content-Type: application/json (list=available)
"{\"list\": { \n \"string\": [\n \"pdsa\",\n \"pdsb\"\n ]\n }\n}\n"
Produces
This API call produces the following media types according to the request header;
the media type will be conveyed by the response header.
text/html
application/xml
application/json
Responses
200
Successful response containing featuretype list.
inline_response_200
Example data
Content-Type: application/json
{"featureTypes": {
"featureType": [
{
"name": "PrimitiveGeoFeature",
"href": "http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/PrimitiveGeoFeature.json"
},
{
"name": "archsites",
"href": "http://localhost:8080/geoserver/restng/workspaces/sf/datastores/sf/featuretypes/archsites.json"
}
]
}
}
Example data
Content-Type: application/xml
PrimitiveGeoFeature
archsites
Example data
Content-Type: application/xml (list=available)
pdsa
pdsb
Example data
Content-Type: application/json (list=available)
{"list": {
"string": [
"pdsa",
"pdsb"
]
}
}
Up
post /workspaces/{workspaceName}/datastores/{storeName}/featuretypes/{featureTypeName}
(postFeatureType)
Invalid. Use POST on the /featuretypes endpoint to add a new feature type, or PUT on an individual feature type to edit that type.
Responses
405
Method not allowed.
Up
post /workspaces/{workspaceName}/featuretypes/{featureTypeName}
(postFeatureType_5)
Invalid. Use POST on the /featuretypes endpoint to add a new feature type, or PUT on an individual feature type to edit that type.
Responses
405
Method not allowed.
Up
post /workspaces/{workspaceName}/datastores/{storeName}/featuretypes
(postFeatureTypes)
Create a new feature type. Note - when creating a new feature type via POST, if no underlying dataset with the specified name exists an attempt will be made to create it. This will work only in cases where the underlying data format supports the creation of new types (such as a database). When creating a feature type in this manner the client should include all attribute information in the feature type representation.
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
storeName (required)
Path Parameter — The name of the datastore
Consumes
This API call consumes the following media types via the request header:
application/xml
application/json
Request body
Body Parameter — The body of the feature type to POST
Responses
201
The feature type was successfully created.
Up
post /workspaces/{workspaceName}/featuretypes
(postFeatureTypes_6)
Create a new feature type, the feature type definition needs to reference a store. Note - when creating a new feature type via POST, if no underlying dataset with the specified name exists an attempt will be made to create it. This will work only in cases where the underlying data format supports the creation of new types (such as a database). When creating a feature type in this manner the client should include all attribute information in the feature type representation.
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
Consumes
This API call consumes the following media types via the request header:
application/xml
application/json
Request body
Body Parameter — The body of the feature type to POST
Responses
201
The feature type was successfully created.
Up
put /workspaces/{workspaceName}/datastores/{storeName}/featuretypes/{featureTypeName}
(putFeatureType)
Update an individual feature type
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
storeName (required)
Path Parameter — The name of the datastore
featureTypeName (required)
Path Parameter — The name of the feature type
Consumes
This API call consumes the following media types via the request header:
application/xml
text/xml
application/json
text/json
Request body
Body Parameter — The body of the feature type to POST
Query parameters
recalculate (optional)
Query Parameter — Specifies whether to recalculate any bounding boxes for a feature type. Some properties of feature types are automatically recalculated when necessary. In particular, the native bounding box is recalculated when the projection or projection policy are changed, and the lat/lon bounding box is recalculated when the native bounding box is recalculated, or when a new native bounding box is explicitly provided in the request. (The native and lat/lon bounding boxes are not automatically recalculated when they are explicitly included in the request.) In addition, the client may explicitly request a fixed set of fields to calculate, by including a comma-separated list of their names in the recalculate parameter. The empty parameter 'recalculate=' is useful avoid slow recalculation when operating against large datasets as 'recalculate=' avoids calculating any fields, regardless of any changes to projection, projection policy, etc. The nativebbox parameter 'recalculate=nativebbox' is used recalculates the native bounding box, while avoiding recalculating the lat/lon bounding box. Recalculate parameters can be used in together - 'recalculate=nativebbox,latlonbbox' can be used after a bulk import to recalculate both the native bounding box and the lat/lon bounding box.
Responses
200
The feature type was successfully updated.
Up
put /workspaces/{workspaceName}/featuretypes/{featureTypeName}
(putFeatureType_7)
Update an individual feature type in the default data store for the workspace
Path parameters
workspaceName (required)
Path Parameter — The name of the workspace
featureTypeName (required)
Path Parameter — The name of the feature type
Consumes
This API call consumes the following media types via the request header:
application/xml
text/xml
application/json
text/json
Request body
Body Parameter — The body of the feature type to POST
Query parameters
recalculate (optional)
Query Parameter — Specifies whether to recalculate any bounding boxes for a feature type. Some properties of feature types are automatically recalculated when necessary. In particular, the native bounding box is recalculated when the projection or projection policy are changed, and the lat/lon bounding box is recalculated when the native bounding box is recalculated, or when a new native bounding box is explicitly provided in the request. (The native and lat/lon bounding boxes are not automatically recalculated when they are explicitly included in the request.) In addition, the client may explicitly request a fixed set of fields to calculate, by including a comma-separated list of their names in the recalculate parameter. The empty parameter 'recalculate=' is useful avoid slow recalculation when operating against large datasets as 'recalculate=' avoids calculating any fields, regardless of any changes to projection, projection policy, etc. The nativebbox parameter 'recalculate=nativebbox' is used recalculates the native bounding box, while avoiding recalculating the lat/lon bounding box. Recalculate parameters can be used in together - 'recalculate=nativebbox,latlonbbox' can be used after a bulk import to recalculate both the native bounding box and the lat/lon bounding box.
Responses
200
The feature type was successfully updated.
Up
put /workspaces/{workspaceName}/datastores/{storeName}/featuretypes
(putFeatureTypes)
Invalid. Use POST for adding a new feature type, or PUT on an individual feature type to edit that type.
Responses
405
Method not allowed.
Up
put /workspaces/{workspaceName}/featuretypes
(putFeatureTypes_8)
Invalid. Use POST for adding a new feature type, or PUT on an individual feature type to edit that type.
Responses
405
Method not allowed.
[ Jump to Methods ]
Table of Contents
FeatureTypeInfo
-
FeatureTypeInfo_attributes
-
FeatureTypeInfo_attributes_attribute
-
FeatureTypeInfo_dataLinks
-
FeatureTypeInfo_dataLinks_metadataLink
-
FeatureTypeInfo_keywords
-
FeatureTypeInfo_latLonBoundingBox
-
FeatureTypeInfo_metadatalinks
-
FeatureTypeInfo_metadatalinks_metadataLink
-
FeatureTypeInfo_namespace
-
FeatureTypeInfo_nativeBoundingBox
-
FeatureTypeInfo_responseSRS
-
FeatureTypeInfo_store
-
MetadataEntry
- entry
inline_response_200
-
inline_response_200_1
-
inline_response_200_featureTypes
-
inline_response_200_featureTypes_featureType
-
name (optional)
String The name of the resource. This name corresponds to the "published" name of the resource.
nativeName (optional)
String The native name of the resource. This name corresponds to the physical resource that feature type is derived from -- a shapefile name, a database table, etc...
namespace (optional)
title (optional)
String The title of the resource. This is usually something that is meant to be displayed in a user interface.
abstract (optional)
String A description of the resource. This is usually something that is meant to be displayed in a user interface.
keywords (optional)
metadatalinks (optional)
dataLinks (optional)
nativeCRS (optional)
String The native coordinate reference system object of the resource.
srs (optional)
String Returns the identifier of coordinate reference system of the resource.
nativeBoundingBox (optional)
latLonBoundingBox (optional)
metadata (optional)
store (optional)
cqlFilter (optional)
String The ECQL string used as default feature type filter
maxFeatures (optional)
Integer A cap on the number of features that a query against this type can return.
numDecimals (optional)
BigDecimal The number of decimal places to use when encoding floating point numbers from data of this feature type.
responseSRS (optional)
overridingServiceSRS (optional)
Boolean True if this feature type info is overriding the WFS global SRS list
skipNumberMatched (optional)
Boolean True if this feature type info is overriding the counting of numberMatched.
circularArcPresent (optional)
linearizationTolerance (optional)
BigDecimal Tolerance used to linearize this feature type, as an absolute value expressed in the geometries own CRS
attributes (optional)
Wrapper for the derived set of attributes for the feature type.
A single attribute
name (optional)
minOccurs (optional)
Integer Minimum number of occurrences of the attribute.
maxOccurs (optional)
Integer Maximum number of occurrences of the attribute.
nillable (optional)
Boolean Flag indicating if null is an acceptable value for the attribute.
binding (optional)
String The java class that values of this attribute are bound to.
length (optional)
Integer Returns the length of this attribute. It's usually non null only for string and numeric types"
Wraps a collection of data links for the resource.
type (optional)
content (optional)
A collection of keywords associated with the resource.
string (optional)
array[String] List of keyword values with internationalization and vocabulary
The bounds of the resource in lat / lon. This value represents a "fixed value" and is not calculated on the underlying dataset.
minx (optional)
maxx (optional)
miny (optional)
maxy (optional)
crs (optional)
String The coordinate reference system object of the bounding box.
Wraps a collection of metadata links for the resource.
type (optional)
metadataType (optional)
String The type of metadata, e.g. "FGDC"
content (optional)
The namespace URI of the resource. Example would be an application schema namespace URI.
name (optional)
String The name of the namespace.
href (optional)
Returns the bounds of the resource in its declared CRS.
minx (optional)
maxx (optional)
miny (optional)
maxy (optional)
crs (optional)
String The coordinate reference system object of the bounding box.
The SRSs that the WFS service will advertise in the capabilities document for this feature type (overriding the global WFS settings).
The store the resource is a part of.
@class (optional)
name (optional)
href (optional)
@key (optional)
String Key used for metadata entry, additional keys are added over time
regionateStrategy
regionateFeatureLimit
cacheAgeMax
cachingEnabled
regionateAttribute
indexingEnabled
dirName
$ (optional)
String Text value for provided key Valid text depends on key used. Example {'@key'='cachingEnabled','$'='true'}.
name (optional)
link (optional)