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.

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.

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.

Commonly Asked Questions

I've received my email, but I can't find my API Key or Password.

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

My API Key and/or Password doesn't work.

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

I'm having trouble integrating with my GIS application software

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

I'm using the service but I'm receiving an error message.

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:

I'd like to extend my licensed area of interest. How do I do it?

Our customer support team will be happy to help:

Known Limitations

Feature limit with ArcGIS or Cadcorp

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.

Non-spatial filtering in ArcGis

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

Spatial filtering in Cadcorp

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.

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.