GetCapabilities
Descripción
El servicio GetCapabilites permite al usuario obtener metadatos sobre el motor de enrutamiento implementado. Estos metadatos permiten a los usuarios explorar un servicio y sus capacidades, optimizando así su experiencia con el uso de los servicios de enrutamiento.
Está disponible solo como servicio REST.
http://<server>:<port>/rest/Spatial/erm/v1/capabilities.json
Parámetros de consulta
Parámetro | Requerido | Descripción |
---|---|---|
acceptVersions | Opcional | Marcador (no funcional) |
secciones | Opcional Cuando se omite, devuelve información sobre todas las secciones. |
La lista no ordenada separada por coma de cero o más nombres de secciones del documento de metadatos del servicio se devuelve en el documento de metadatos del servicio. Los valores de sección distinguen mayúsculas de minúsculas. Los valores de sección aceptados son ServiceIdentification, ServiceProvider, operationsMetadata y bases de datos. |
Respuesta
La respuesta estará en línea con OGC GetCapabilities. Este es el formato JSON y tiene estas secciones:
- serviceIdentification
- serviceProvider
- operationsMetadata
- bases de datos
serviceIdentification
Esta sección contiene metadatos básicos sobre este servidor específico. Su contenido se muestra de la siguiente manera:
"serviceIdentification":
{
"title": "PBS Routing Service",
"abstract": "Routing service maintained by PBS",
"keywords":
{
"keyword":
[
]
},
"serviceType": "Routing",
"serviceTypeVersion": "v1",
"fees": "none",
"accessConstraints": "none"
}
Esta información será igual que la que está disponible en el archivo de configuracióngetCapabilities.json.
Este archivo se encuentra en<SpectrumFolder>\server\modules\routing. Debe reiniciar el servidor en caso de cualquier cambio efectuado en el archivo, para que este tenga efecto. El administrador determina qué información debe obtener el usuario y puede modificar o eliminar las entradas correspondientes en el archivo JSON. Todos los campos en el archivo JSON son opcionales.
serviceProvider
Esta sección contiene metadatos sobre la organización que opera este servidor. Su contenido se muestra de la siguiente manera:
"serviceProvider":
{
"providerName": "Routing Service Provider",
"providerSite":
{
"href": "http://www.yourcompany.com/",
"type": "simple"
},
"serviceContact":
{
"contactInfo":
{
"address":
{
"administrativeArea": "Province",
"city": "City",
"country": "Country",
"deliveryPoint": "Mail Delivery Location",
"electronicMailaddress":"mailto://support@yourcompany.com",
"postalCode": "PostCode"
},
"contactInstructions": "Contact Instructions",
"hoursOfservice": "24 Hours",
"phone":
{
"facsimile": "1.800.000.0000",
"voice": "1.800.000.0000"
}
},
"individualName": "Contact Person",
"positionName": "Contact Person's Title",
"role": "Contact Person's Role"
}
}
Esto también se configurará usando el archivo de configuración getCapabilities.json como describimos antes.
operationsMetadataEsta sección contiene metadatos sobre las operaciones implementadas por este servidor, incluidas las direcciones URL para solicitudes de operación. En esta sección, aparecen estas operaciones o servicios fijos:
- GetRoute: servicio punto a punto
- GetRouteCostMatrix: servicio de procesamiento de matriz de puntos
- DescribeDatasets: ofrece información sobre los conjuntos de datos configurados
- DescribeDatabases: ofrece información sobre todas las bases de datos configuradas.
Su contenido se muestra de la siguiente manera:
{"operationsMetadata": [{
"name": "GetRoute",
"DCP": {
"HTTP": {
"GET": "<schema>://<server>:<port>/rest/Spatial/erm/databases/<DB_NAME>.json?q=route",
"POST": "<schema>://<server>:<port>/rest/Spatial/erm/databases/<DB_NAME>.json?q=route"
}
},
"parameter": {
"name": "OutputFormat",
"value": "text/json"
}
}, {
"name": "GetRouteCostMatrix",
"DCP": {
"HTTP": {
"GET": "<schema>://<server>:<port>/rest/Spatial/erm/databases/<DB_NAME>.json?q=routeCostMatrix",
"POST": "<schema>://<server>:<port>/rest/Spatial/erm/databases/<DB_NAME>json?q=routeCostMatrix"
}
},"parameter": {
"name": "OutputFormat",
"value": "text/json"}},{"name": "GetTravelBoundary","DCP": {
"HTTP": {
"GET": "<schema>://<server>:<port>/rest/Spatial/erm/databases/<DB_NAME>json?q=travelBoundary",
"POST": "<schema>://<server>:<port>/rest/Spatial/erm/databases/<DB_NAME>.json?q=travelBoundary"
}
},
"parameter": {
"name": "OutputFormat",
"value": "text/json"
}
}, {
"name": "DescribeDatasets",
"DCP": {
"HTTP": {
"GET": "<schema>://<server>:<port>/rest/Spatial/erm/v1/datasets.json"
}
},
"parameter": {
"name": "OutputFormat",
"value": "text/json"
}
}, {
"name": "DescribeDatabases",
"DCP": {
"HTTP": {
"GET": "<schema>://<server>:<port>/rest/Spatial/erm/v1/databases.json"
}
},
"parameter": {
"name": "OutputFormat",
"value": "text/json"
}
}]
}
bases de datos
Esta sección contiene la lista de nombres de bases de datos que están configuradas en el servidor.
Por ejemplo:
{
"databases":
[
"US_NE",
"US"
]}
Si no hay una base de datos configurada en el servidor, se devuelve esto:
{
"databases":[
]
}