Emapsite.com

Introduction To WFS

Welcome to the Emapsite Technical Help Site.

Thank you for purchasing this Emapsite online service, where Emapsite manages the geospatial database and datasets to leave you free to run your business.

The information provided in this site will help you get the most from the service. Everything you need to get started and interact successfully with the service should be here. And should you require anything else, please contact Customer Support:

Customer Support Telephone: 01189 973 6883
Customer Support Email: customersupport@emapsite.com
Emapsite Address The Hub
Fowler Avenue
Farnborough
GU14 7JF
United Kingdom
Emapsite Website: www.emapsite.com

Getting Started With WFS

Before you can access Emapsite's API webservices you will need the following:

  • Your API Key
  • Your API Key Passphrase
  • Your GetCapabilities Url

If you are missing any of these they can be found in your welcome email.

You can also find all your licensed products by entering your API Key name and Passphrase at:

Authentication

Emapsite's APIs use BASIC Authentication.

The following javascript demonstrates how to add a BASIC authentication header to your requests.

1   var user = 'Your API Key';
2   var pass = 'Your Pass Phrase'
3    
4   headers.set('Authorization', 'Basic ' + base64.encode(user + ":" + pass));

If using GIS software please see integrations on how to apply your BASIC authentication.

Integrations

The instructions below are for connecting to Emapsite's Online Services using GIS Software. 

Note - The instructions are for connecting to WFS

ArcGis

The following fields are required in order to access Emapsite's Online Services:

  • Server URL - Your Get Capabilities URL.
  • Version - Emapsite's Online Services are available in version 1.0.0, 1.1.0 and 2.0.0. We recommend 2.0.0.

Custom Parameters

  • Bbox - Bounding box is mandatory and has to be added manually here. This is a limitation of ArcGIS software.

Authentication

  • User Name - Your Emapsite API Key name.
  • Password - Your Emapsite API Key password.

CAD Corp

The following set of images provide step by step instructions on connecting to Emapsite's Online Services.

Step 1 - Add an overlay type of OGC Web Feature Service. Click Next.

Screenshot showing OGC overlay type selection

Step 2 - The following fields are required:

  • URL - Your Get Capabilities URL.
  • User Name - Your Emapsite API Key name.
  • Password - Your Emapsite API Key password.

Click Next.

Step 3 - Click Next.

Step 4 - Click Next.

Step 5 -  Ensure Simple Filter is selected and Spatial Filter has been checked. Intersect with current view extent must be selected from the dropdown list. Click Finish.

QGIS

The following fields are required in order to access Emapsite's Online Services:

  • URL - Your Get Capabilities URL.

Authentication

  • User Name - Your Emapsite API Key name.
  • Password - Your Emapsite API Key password.

WFS Options

  • Enable feature paging - In order to leverage the pagination features of WFS this must be ticked.
Screenshot showing enabling of feature paging in WFS Connection Options

Datasets

The datasets available through this service are intended for use by customers with pre-existing data licences for the following datasets:

  • Ordnance Survey MasterMap
  • Ordnance Survey AddressBASE Premium
  • HM Land Registry National Spatial Dataset
  • HM Land Registry HMLR CCOD (Commercial & Corporate Ownership Data)

Feature requests can be returned in the following formats:

  • GML2
  • GML3

The WFS service applies ‘geofencing’ so that customers can consume their existing licensed data with confidence. We also licence dataset expansions for when customers wish to explore the data beyond their licensed area. Please contact Customer Support:

Customer Support Telephone: 01189 973 6883
Customer Support Email: customersupport@emapsite.com
Emapsite Address The Hub
Fowler Avenue
Farnborough
GU14 7JF
United Kingdom
Emapsite Website: www.emapsite.com

FAQs

We've tried to cover all the bases, but there might still be a few questions.

Commonly Asked Questions

You should have received your API Key and password in your welcome email. If you're unable to find these then contact customer support

Customer Support Telephone: 01189 973 6883
Customer Support Email: customersupport@emapsite.com

Please ensure you've copied the API Key and Password from email correctly. If you're still experiencing issues contact our customer support:

Customer Support Telephone: 01189 973 6883
Customer Support Email: customersupport@emapsite.com

The step by step is contained in the integrations section, but we'd be delighted to help you.

Customer Support Telephone: 01189 973 6883
Customer Support Email: customersupport@emapsite.com

You may have received one of the following errors:

  • Area is outside licensed coverage. - The area requested is outside of your licensed coverage. Our customer support team will be happy to assist you in purchasing additional coverage.
  • API Key Source has expired. - Your license has expired.
  • Sorry it doesn't look like you have access to this layer... - You have attempted to access a layer that you have not licensed. Our customer support team will be happy to assist you in purchasing additional layers.
  • API Key Source has been suspended. - Your API Key has been disabled.
  • The BBOX or Polygon query string value is invalid. - The bounding box area you've requested isn't valid.

If your error is not listed then reach out to our support team who will be happy to help:

Customer Support Telephone: 01189 973 6883
Customer Support Email: customersupport@emapsite.com

Our customer support team will be happy to help:

Customer Support Telephone: 01189 973 6883
Customer Support Email: customersupport@emapsite.com

Known Limitations

The service is designed to return up to 1000 features per feature request, but for ArcGIS and CAD Corp are limited to receiving a maximum of 500 features per request. This is a limitation of the application software.

A software limitation means that the ArcGis software does not accept non-spatial filtering instructions.

A software limitation means that Cadcorp software permits spatial filtering based on screen extents, but full bounding box filtering does not function on WFS 2.0.

Emapsite APIs

Emapsite online service products comprise Open Geospatial Consortium (OGC) compliant web services and Query-API products.

These products are intended for customers who prefer to focus on their business activity and have geospatial database and datasets hosted, managed, and maintained by Emapsite professionals.

OGC Compliant Services

Emapsite introduced the first commercial OGC compliant Web Map Service in 2006 and our customers have trusted us ever since to help them make smarter business decisions:

  • Web Map Service
  • Web Map Tile Service
  • Web Feature Service

Query-API Products

These products enable customers to query the whole range of Emapsite geospatial datasets and stream responses directly into a GIS or other geospatial application. We provide unlimited access to licensed datasets from household names such as Ordnance Survey, HM Land Registry and Environment Agency, through to specialist publishers plus our own range of value-added and derived data products.

Emapsite also provides data cleansing services using artificial intelligence and machine learning techniques to improve the quality of customer-provided data (e.g. lists of addresses). A cleansed dataset underpins successful location analytics activities and further improves problem solving and decision making.

Emapsite is the trusted source of reliable mapping data and spatially enabled, business intelligence products. You will access to the wideset range of datasets and be confident that the whole team is using the same trusted data source. These services are intended to be convenient to help you gain competitive advantage by doing things faster, more consistently and with higher output.