Language

Using GIS Tools

DELETED

You can can download our new streaming process user guide here while the documentation update on this portal is in progress

The OneAtlas Basemap streaming services follows rigorously the standards of the protocols it is compatible with. Consequently, the integration of our endpoints in the GIS tools is straightforward.

Prerequisites: If you haven’t already, see our Authentication Guide for information on how to acquire your Basemap API Key to access the OneAtlas Basemap endpoints. Be aware that the credentials provided with your Basemap API key are enough to access the basemap through GIS Tools.

Below is summarized the GIS tools compatibility with the protocols available in OneAtlas Basemap.

WMSWMTSWFSAGS RestAGS SoapKML
ArcMap
ArcGIS Pro
ArcGIS Online
QGIS
ArcEarth
Google Earth Pro

QGIS

You can easily access to the OneAtlas data imagery with OSGeo's QGIS Desktop application. QGIS is an Open Source Geographic Information System (GIS) licensed under the GNU General Public License. QGIS currently can act as a WMS and WMTS client.

Prerequisites

If your network is protected by a proxy you first need to enter the relevant settings. From the “Settings” menu, click on “Options” and then on “Network” to set the proxy settings.

WMS/WMTS Streaming in QGIS

The procedure to follow is documented directly on the QGIS website


In the menu “Layer” / “Add Layer” / “Add WMS/WMTS Layer…” / “New”, you will need to provide:

The resulting dialog box filled out for WMS basemap streaming should look like:

QGISnewWMS.jpg

The resulting dialog box filled out for WMTS basemap streaming should look like:

QGISnewWMTS.jpg

If you have entered the correct details, this should be the result in QGIS:

QGISshanghai.jpg

WFS Access in QGIS

In the menu select “Layer” / “Add Layer” / “Add WFS Layer…” / “New” you will need to provide:

The resulting dialog box filled out for WFS metadata should look like:

wfs_metadata.jpg

Select the layer you just entered in the list of available layers and click on “Connect”.

wfs_layer.jpg

Once you successfully connected to the endpoint the list of available layers is displayed. Select the layer you want to access and finally, click on “Add” to display the layer into the map and click on “Close” once it is loaded.

wfs_add.jpg

The following window will be displayed during the loading of the features (metadata tiles). Then all the footprints of the basemap images will be displayed on the map, and the attribute table provides all the metadata:

wfs_loaded.png

Note: Due to an issue with QGIS you need to select “Open Attribute Table” on the WFS layer to make all the WFS entities to load in QGIS. Moreover, there are a very large number of entities in the WFS and the loading time can take several minutes.

QGIS - OneAtlas Basemap plugin

You can display a set of search and selected images by using the OneAtlas plugin for QGIS 3.

Installation

Go to “Plugins” menu and select “Manage and Install Plugins…”. Search for “OneAtlas” and select the “OneAtlas” plugin on the result, and click on the “Install plugin” button.

10.png

11.png

Overview of the plugin

  • Display search window 1.png

  • Display one imagery stream (after selecting the footprint found) 2.png

Search Window

  1. “Configuration” tab
  2. Enter your Basemap credentials (username and password) for searching OneAtlas Basemap
  3. Enter your API key for searching OneAtlas Data (Living Library)

3.png

  1. Use an Area Of Interest (AOI)
  2. By clicking on “Draw” button
  3. By loading your own shape, selecting it and clicking on “Use selected” button

4.png

  1. “Basemap” tab - For Searching Basemap
  2. Click on “Basemap search” button

5.png

  1. “Data” tab - For Searching Living Library
  2. Set your search criterias
  3. Click on “Data search” button

6.png

Display imagery stream

  • Select the footprint of the imagery expected
  • Click on the “Display Imagery” button of the toolbar

7.png 8.png

For Living Library Imagery (“Data” tab), if you have ordered the image you can select the stream (protocol) expected and select the representation (style).

9.png

ArcGIS Desktop

WMS/WMTS Streaming in ArcGIS Desktop

You can easily access to the OneAtlas Basemap imagery with ESRI ArcGIS Desktop, a commercial product used by GIS professionals to compile, use, and manage geographic information. The procedure to follow is documented directly on the ESRI website.


You will need to provide:

The resulting dialog box filled out for WMS basemap streaming should look like:

ArcMapWMS.jpg

The resulting dialog box filled out for WMTS basemap streaming should look like:

ArcMapWMTS.jpg

And the result in ArcMap is:

ArcMapPilat.jpg

WFS Access in ArcGIS Desktop

Prerequisites

The use of WFS requires the user to install the Data Interoperability extension first, and then the user needs to add the Interoperability Connections folder into ArcMap.

Add WFS Server Into ArcMap

In the catalog tab, select the “Interoperability Connections / Add Interoperability Connection” folder. Then select “WFS (Web Feature Service)” as format and then click on the “Parameters…” button:


You will need to provide:

  • The WFS endpoint (see Manage Subscriptions)
  • WFS version: select 2.0.0
  • Credentials authorized to display the basemap (see Authenticate Guide)
  • Proxy server (if your network is protected by a proxy)

The resulting dialog box filled out for WFS should look like:

wfs_parameters.png

Add the layers with “Add Data” or click on the catalog tab to open the new WFS layer located in the Interoperability Connections folder as displayed here-below.

int_conn.jpg

Drag & drop the “ONELIVE Polygon” in the table of content and wait for the features to be loaded and displayed.

load_display.png

SOAP Access

Select “Add ArcGIS server” / “Use GIS services”:

add_server.jpg

You will need to provide:

Click on “Add Data”, go to the GIS Servers category to display this new layer.

add_data.png

Drag and drop the OneAtlas layer on the map or in the table of content.

ArcGIS Desktop OneAtlas Basemap AddIn

You can display a set of search and selected images by using the ArcGIS Desktop AddIn

Prerequisites

The use of WFS requires the user to install ArcGIS for Desktop 10.5 or higher.

Installation

Double click on OneAtlas Basemap AddIn file 1.gif Launch ArcMap and activate toolbar by clicking on “Customize > Toolbars > OneAtlas Images Search Toolbar” 2.png 3.png

Overview of the AddIn

Search for OneAtlas Basemap Images 4.png Draw a rectangular Area Of Interest 5.png Draw a polygon Area Of Interest 6.png Erase current Area Of Interest 7.png Change connection settings 8.png

Searching and displaying images

Draw an Area Of Interest by using the rectangular tool. 9.gif Open search window, define search criterias, and launch the search by clicking on “Search By AOI”. 10.png Enter your OneAtlas Basemap credentials and press “Login” button. 11.png Click on “Search with limitations” buttons, the bounding box of all the images found in catalog is displayed. 12.gif Select images to view the metadata. 13.gif Click on “Add Selected Images as Layers” button to display the image in full resolution using WMTS endpoint. 14.gif 15.gif

ArcMap layers available

“AOI & Search Criteria” layer, store Area Of Interest bounding box and the criterias used for your search 16.gif “Search Results” layer, store bounding box and metadata of the images found 17.gif

Searching by ID

Put the IDs of the images, and click on button “Search By IDs” 18.png Select images to view the metadata. 19.gif Click on “Add Selected Images as Layers” button to display the image in full resolution using WMTS endpoint. 20.gif

Google Earth Pro

WMS Access in Google Earth Pro

Click on “Add” from the toolbar and select “Image Overlay”. Enter the name of your layer in the “Name” field. Then click on the “Refresh” tab and select “WMS Parameters”:

ge_new_image.png

Select the layers you want to add on the left part of the window, then click “Add ->” to move it on the right part of the window. Once the layers are selected, click on “OK”.

ge_web_map.png

Notice that the “Link” field is now filled with the appropriate syntax. Click again on “OK”.

ge_link.jpg

Your layer now appears in the “Places” of Google Earth as displayed here-below.

ge_places.jpg

Click on the layer to display it on the map, you will be prompt to enter your OneAtlas Basemap credentials (username and password).

ge_image.jpg

Load a KML in Google Earth Pro

Right click on one of the folders or files of the “Places” panel (on the left hand side of the window). Select “Add > Network Link” to open a new window. Enter the name of your layer in the “Name” field. Paste the link of the KML you want to display. You might need to enter your OneAtlas credentials (username and password) to display the layer.

ge_kml.jpg

Your layer now appears in the “Places” of Google Earth:

ge_kml_places.jpg

Click on the layer to display it on the map, you will be prompted to enter your OneAtlas login and password.

ge_kml_map.png

If you wish to add the KML layer of the OneAtlas metadata, follow the same steps above to display them on the map.

ge_kml_map2.jpg

ArcGIS Earth

WMS/WMTS Access in ArcGIS Earth

Click on the “+” button from the toolbar to add new data in the virtual globe:

arcgis_home.png

Make sure to be in the tab named “Enter a URL”, then select the “OGC WMS” or “OGC WMTS”. Type in the drop-down list:

arcgis_url

You will need to provide:

arcgis_url

You will be prompted to enter your OneAtlas Basemap credentials (username and password). At the end of the retrieving process, you layer can be accessed on the left panel of the main ArcGIS Earth window.

arcgis_panel.jpg

ArcGIS Pro

WMS/WMTS Access in ArcGIS Pro

Select “New WMS Server” or “New WMTS Server”.


You will need to provide:

pro_wms.jpg

From the “Project” panel, click on “Servers“ to display the list of available servers, you should see the corresponding OneAtlas layer.

pro_project.jpg

Right click on the OneAtlas layer and select “Add To New Map” to display it into the main window:

pro_display.png

ArcGIS Enterprise

WMS/WMTS Access in ArcGIS Enterprise

Go to your ArcGIS Enterprise instance and authenticate.
Click on the “Map” menu and then on “Modify Map” on the upper right corner of the map, next to the “Sign In” button.
Select “Add Layer from the Web” then “A WMTS OGC Web Service” from the drop down list as type of data to reference. You will need to provide:
- The WMTS endpoint of OneAtlas Basemap
- Credentials to be authorized to display the basemap (see Authenticate Guide)
OAB_ArcGIS_Enterprise.png The layer name will be displayed in the ArcGIS Enterprise “Table Of Content” on the left hand side of the map. Meanwhile, the layer will be displayed on the map.

ArcGIS Online

WMS/WMTS Access in ArcGIS Online

Go to ArcGIS Online: http://www.arcgis.com/home/webmap/viewer.html.

Click on “Modify Map” or “New Map” on the upper right corner of the map, next to the _“Sign In” button.

Note: you will need an ArcGIS Online account to “Sign In”.

Select “Add” / “Add Layer from the Web”:

pro_add.png

Select “An ArcGIS Server Web Service” from the drop down list as type of data to reference:

pro_add_layer.jpg

You will need to provide:

pro_add_layer2.jpg

The layer name will be displayed in the ArcGIS Online “Table Of Content” on the left hand side of the map as displayed below:

pro_mymap.jpg

Meanwhile, the layer will display on the map:

pro_map.png

Contact Us