Base Spatial Dataset Engine Reference¶
Last Updated: January 30, 2015
All SpatialDatasetEngine objects provide a minimum set of methods for interacting with layers and resources. Specifically, the methods allow the standard CRUD operations (Create, Read, Update, Delete) for both layers and resources.
All SpatialSpatialDatasetEngine methods return a dictionary called the response dictionary. The Response dictionary contains an item named ‘success’ that is a boolean indicating whether the operation was successful or not. If ‘success’ is True, then the the dictionary will also have an item named ‘result’ that contains the result of the operation. If ‘success’ is False, then the Response dictionary will contain an item called ‘error’ with information about what went wrong.
The following reference provides a summary of the base methods and properties provided by all SpatialDatasetEngine objects.
Properties¶
SpatialDatasetEngine. endpoint (string): URL for the spatial dataset service API endpoint.
SpatialDatasetEngine. apikey (string, optional): API key may be used for authorization.
SpatialDatasetEngine. username (string, optional): Username key may be used for authorization.
SpatialDatasetEngine. password (string, optional): Password key may be used for authorization.
SpatialDatasetEngine. type (string, readonly): Identifies the type of SpatialDatasetEngine object.
Create Methods¶
- SpatialDatasetEngine.create_resource(resource_id, **kwargs)¶
Create a new resource.
Parameters: - resource_id (string) – Identifier of the resource to create.
- **kwargs (kwargs, optional) – Any number of additional keyword arguments.
Returns: Response dictionary
Return type: (dict)
- SpatialDatasetEngine.create_layer(layer_id)¶
Create a new layer.
Parameters: layer_id (string) – Identifier of the layer to create. Returns: Response dictionary Return type: (dict)
Read Methods¶
- SpatialDatasetEngine.get_resource(resource_id)¶
Retrieve a resource object.
Parameters: resource_id (string) – Identifier of the dataset to retrieve. Returns: Response dictionary Return type: (dict)
- SpatialDatasetEngine.get_layer(layer_id)¶
Retrieve a single layer object.
Parameters: layer_id (string) – Identifier of the layer to retrieve. Returns: Response dictionary Return type: (dict)
- SpatialDatasetEngine.list_resources()¶
List all resources available from the spatial dataset service.
Returns: Response dictionary Return type: (dict)
- SpatialDatasetEngine.list_layers()¶
List all layers available from the spatial dataset service.
Returns: Response dictionary Return type: (dict)
Update Methods¶
- SpatialDatasetEngine.update_resource(resource_id, **kwargs)¶
Update an existing resource.
Parameters: - resource_id (string) – Identifier of the resource to update.
- **kwargs (kwargs, optional) – Any number of additional keyword arguments.
Returns: Response dictionary
Return type: (dict)
- SpatialDatasetEngine.update_layer(layer_id, **kwargs)¶
Update an existing layer.
Parameters: - layer_id (string) – Identifier of the layer to update.
- **kwargs (kwargs, optional) – Any number of additional keyword arguments.
Returns: Response dictionary
Return type: (dict)
Delete Methods¶
- SpatialDatasetEngine.delete_resource(resource_id)¶
Delete a resource.
Parameters: resource_id (string) – Identifier of the resource to delete. Returns: Response dictionary Return type: (dict)
- SpatialDatasetEngine.delete_layer(layer_id)¶
Delete a layer.
Parameters: layer_id (string) – Identifier of the layer to delete. Returns: Response dictionary Return type: (dict)