How to use the Services

This page has links to instructions for using Esri UK’s online map and gazetteer services across the ArcGIS platform.

Enquire about subscribing to premium map services.


Map Services and Locators

A range of free and premium map services are available to use as basemaps throughout the ArcGIS Platform. For details of the maps available (content, display, data scale etc), see the individual links on the Free Services page and the Premium Services page.

Furthermore we have made available a number of free locators which allow you to search for locations (e.g. streets, places and postcodes), batch geocode and reverse geocode.

For details of the data in each gazetteer, and what types of search are possible, see the individual links on the Free Services page.

The online content services are delivered as REST services that can be consumed directly by any client either within or outside the Esri Platform.

Each content service has its own REST endpoint: see REST endpoint. Use your login details to view/test the services.

ArcGIS for Desktop

To add free basemaps to ArcGIS for Desktop:

  1. Go to File > Add Data, click on the drop down arrow and select Add Basemap
  2. The Add Basemap dialog will be shown with basemaps from the UK and around the world.

To add premium map services and free locators to ArcGIS for Desktop

  1. Go to File > Add Data and select Add Data
  2. Select GIS Servers and click Add ArcGIS Server, Add
  3. In the wizard, choose Use GIS Services
  4. Click Next
  5. Enter https://datahub.esriuk.com/arcgis/services or http://datahub.esriuk.com/arcgis/services
  6. If connecting to premium Services, enter username and password (free gazetteers can be used without entering a username and password)
  7. Click Finish
  8. Select the defined connection and choose a map or gazetteer from the list.
  9. Note: The services can also be added through the Catalog pane in ArcMap or through ArcCatalog

Using the Free Locators -  From the Geocoding Toolbar – Single Line Search, Single Result

  1. Click the drop-down in the first field to select the locator or, if the one you want is not there, select Manage Address Locators (from the drop-down), navigate to the one you want, Add it and Set Active.
  2. Type or paste the location to search for (e.g. a postcode for the OS CodePointOpen Postcode Locator) in the text box.
  3. Press Return, and if a match is found, it will flash on the map and hovering over the address field will display a popup of the full address.
  4. Note: If a single result is not found, a no match is returned. Use the Find button for best results.

From the Find Button – Single Line Search, Multiple Results

  1. On the main toolbar, click the Find icon.
  2. Select the Locations tab.
  3. Click the drop-down to choose a locator or, if the one you want is not there, click the folder icon to browse to it.
  4. Type the single line location to search for (e.g. a postcode for the OS CodePointOpen Postcode Locator).
  5. Click Find.
  6. In the Results panel, clicking on a match makes it flash on the map, and right clicking options include flashing or zooming to the location on the map and bookmarking the location.

Batch Geocoding – Multi Line Search

ArcGIS Pro

Add free basemaps to ArcGIS Pro

Go to MAP > Basemap
The Add Basemap dialog will be shown with basemaps from the UK and around the world.

Add Premium map services to ArcGIS Pro:

To add Premium map services to ArcGIS Pro:

  1. Go to Insert >Connections > New ArcGIS Server
  2. Enter https://datahub.esriuk.com/arcgis/services or http://datahub.esriuk.com/arcgis/services
  3. If connecting to Premium Services, enter username and password (free gazetteers can be used without entering a username and password)
  4. Click OK
  5. To Add Premium Maps
    1. Go to MAP > Add Data and select Add Data
    2. Select Project > Servers and connect to the DataHub Server
    3. Select required map and click OK

Using the Free Locators - Add Locators

To add locators to Pro, Add them to your Organisation in ArcGIS Online or Portal for ArcGIS. They will automatically be added to your project’s Locator list.


Locate Pane

  • Use the Locate Pane to search the locators, enabled from MAP > Locate.
  • Use the Settings panel to select which locators are searched using the Locate panel.

Batch Geocoding

Batch geocode tables from the Toolbox, using Geocoding Tools > Geocode Address, creating output in a new feature class (see About geocoding a table of addresses and Geocoding a table of addresses).

Right click a table of addresses and select Geocode Addresses from the context menu.

Interactively rematch batch geocoded results (see Rematching geocoding results).


Web Clients

Map Services in a Web Application

You can use APIs (e.g. JavaScript ) to create geocoding applications that use these locators, using the REST endpoint.

This is described in the ArcGIS for Server help, e.g. Sharing your map in a web application.

Gazetteer Services in a Web Application

You can use APIs (Flex, JavaScript, Silverlight) to create geocoding applications that use these locators, using the REST endpoint.

The precise functionality will vary, depending on the API and the locator.



ArcGIS Online

ArcGIS Online is a cloud-based platform for sharing and using maps, gazetteers and apps. There is detailed help for ArcGIS Online, starting here: Welcome to ArcGIS Online.

Free Map Services in ArcGIS Online

The free map services can be added as a basemap simply by selecting the Basemap button from within a Map. A dialog is shown listing basemaps from the UK and around the world.

Premium Map Services in ArcGIS Online

Using online map services within ArcGIS Online can be done in several ways:

    1.   Add the service URL as an item to share – without storing login credentials, so users will be prompted for credentials
    2.   Add the service URL as an item to share – storing login credentials
    2b. Add the service URL as an item to share – storing login credentials and restricting the usage of the item
    3.   Add the service directly to a webmap – users prompted for login credentials
    4.   Add the service directly to a webmap – using a token, so users not prompted for credentials

See the Security Guidance document for advice about recommended methods of securing your services in ArcGIS Online in different circumstances.

Note: The free UK Content App available from the Marketplace can be used to automate adding the premium maps as items to your organisation

1. Add the service URL as an item to share with everyone, your organisation, or specific groups – without storing login credentials.

Users will be prompted for credentials whenever they open a map containing this item or try to add this item to a new map:

a. In My Content, select Add Item.
b. Complete the fields, including the URL.
c. Opt NOT to store logon credentials with the service:

d. Click Add Item.

2. Add the service URL as an item to share – storing the user account and access code with the item.

When users with whom you have shared the item access it, they will not be prompted for credentials. Instead, ArcGIS Online will use the credentials you have saved to automatically login,, and will act as a proxy for the online data service (the URL is different e.g.http://utility.arcgis.com/usrsvcs/rest/services/9dba654f6fc249c69848925088f97673/MapServer).

Note that any users with whom you shared the item will have access to the Esri UK Online data service, using your account name and will be able to find and use the item by using the search box in ArcGIS Online.

a. In My Content, select Add Item.
b. Complete the fields, including the URL.
c. Opt to STORE logon credentials with the service:

d. Click Add Item.

2b. Add the service URL as an item to share – storing the credentials and limiting the usage of the item.

Add the item as above so that the credentials are stored with the service

a. In My Content, select the Item.
b. In the item information page you will see an "Advanced Options" section with a link to LIMIT USAGE, select this.
c. Enter the referrer URL that you wish to limit usage to. Some information on the appropriate URLs to enter can be found below.

d. Click OK

Referrer URLs

Entering the base URL of your organisation (e.g. https://techresearch.maps.arcgis.com) will ensure that the item can be used by all applications published from your organisation.

Where you are using applications from the ArcGIS marketplace such as Markr you will also need to allow access from those applications. For Esri UK application this will mean adding a referrer URL of https://apps.esriuk.com/

If you choose to host applications in your own infrastructure which access the content from ArcGIS Online, then you will also need to add those URLs as authorised referrers. e.g. http://www.esriuk.com/

 

3. Add the service directly to a webmap to use in applications.

Users will be prompted for login credentials whenever they open the map, and they will not be able to discover the layer by searching within ArcGIS Online as the service is not an “item”.

a. Click the drop-down beside the Add Data button on the main toolbar.
b. Select Add Layer from Web.
c. Select as an ArcGIS Server Web Service.
d. Add the URL details in the format:
http://datahub.esriuk.com/arcgis/rest/services/folder/<service name>/<service type>
e. Enter the service URL. Users will be prompted for login credentials whenever they access it, and the service will NOT be findable via the ArcGIS Online search box.
f. Optionally tick Use as Basemap:

g. Click on Add Layer.

4. Add the service directly to a webmap – using a long-lived token as part of the URL.

Users will not need to enter their credentials to access the service, as they are encapsulated in the long lived token. Generating a token will require you to specify a URL referrer, which is normally the URL of your ArcGIS Online subscription, e.g. myorg.maps.arcgis.com. It will expire after the specified length of time and the webmap will then need updating.

a. Click the drop-down beside the Add Data button on the main toolbar.
b. Select Add Layer from Web.
c. Select as an ArcGIS Server Web Service.
d. Add the URL details in the format:
http://datahub.esriuk.com/arcgis/rest/services/folder/<service name>/<service type>
e. Include a long-lived token as part of the URL. Users will not be prompted for login credentials.
f. Optionally tick Use as Basemap:

g. Click on Add Layer.

 

Using the Free Locators - Locator Services in ArcGIS Online

Users who belong to an Organisation can use locator services set up by an administrator (i.e. in addition to the World Geocoding Service).

Administrators set up locator services by adding the locators to Utility Service:

  1. Select MY ORGANISATION
  2. Select EDIT SETTINGS
  3. Select UTILITY SERVICES
  4. Click ADD GEOCODER
  5. In the dialog, specify:
    a. The URL of the DataHub geocoding service
    b. A Geocoder Name (will be displayed in drop-down list of geocoders)
    c. Placeholder Text to describe it (will be shown in grey in the search box)
    d. Tick Allow place finding
    e. Tick Allow batch geocoding
    f. Click OK to close the dialog
    g. At the top left of the page, click SAVE

The service should now be available to ArcGIS Online users in your organisation

To use a locator service for single line search:

  1. View a map
  2. In the search dialog at the top right, click the drop-down list, and select a geocoder
  3. Enter a search string (e.g. a postcode for a postcode locator)
  4. Press Return or click the search icon
  5. The map should zoom to the location
  6. To see other matches and possible matches, click Not what you wanted?, in the dialog pointing to the best match on the map

To use a locator service for batch geocoding a CSV file:

  1. View a map
  2. Add the data in one of two ways:
    • Drag and drop the file from your desktop onto the map
    • In the browser, select Add Layer from File, navigate to a CSV file and click IMPORT LAYER
  3. In the dialog
    a. Select to Locate features using Address
    b. Select the Geocoder from the drop-down list
    c. Select which fields in the data correspond to types of location, e.g. streetlocality in the CSV may map to Full Street as a location field
    d. Click Add Layer to start geocoding
  4. When geocoding is finished, successfully matched points will be marked on the map and a message will tell you how many records did not match


Contact Us | Cookies | Privacy | Legal | Slavery/Human Trafficking Statement