ArcGIS
  • 14 Jun 2024
  • 4 Minutes to read
  • Dark
    Light
  • PDF

ArcGIS

  • Dark
    Light
  • PDF

Article summary


The tutorial page includes the following sections:


Before you start

You will require an API Key to pass authentication and access MetroMap's API Services in Esri software. API Keys are available from MetroMap Support.

You will need to have a MetroMap Enterprise or Partner plan to receive an API Key and access MetroMap APIs


ArcGIS Pro - WMTS/WMS

1. Create a new Project in ArcGIS Pro.

Pick either WMTS Server or the WMS Server from the Connections menu. We recommend WMTS.
ArcGispro2-8.png


2. Create Your URL

Refer to either WMS or WMTS for the URL you need depending on which service you would like. Use this URL with your MetroMap API key embedded within for the server URL input. 'Server URL' is the only line to fill out, thus you can select 'OK' after entering the complete URL.

ArcGIs2-8-2.png

3. Add Catalog View

Click on the view tab and select the catalog View option.
ArcGis2-8-3.png

4. Add WMTS/WMS Layers

Click on the server’s folder to access the MetroMap service, then double click twice to access the available layers.
ArcGis2-8-4.png

5. Selecting Layer

Right click on desired aerial photography and add to map or scene. Multiple selections are possible by holding shift or control and select.
ArcGis2-8-5.png

We recommend the 'Australia latest' layer for seamless national coverage;
ArcGis2-8-6.png

For more information visit ESRI help page by clicking here.

Back to Top


ArcGIS Online

1. Creating ArcGIS Online Items

This method is for creating an ArcGIS Online item of a WMS or WMTS service layer which can be later included into Esri software maps or applications.

In the Content section of ArcGIS Online, select 'New Item'.

Item1.png

For the source of the new item, choose the "URL" option as a URL will be used to connect to the desired MetroMap service.

Item2.png

Next is creating the URL for connecting to the service. For this, refer to either WMS or WMTS for the correct URL format depending on which service you would like. Next embed your MetroMap API key within to replace the URL's "{YOUR-API-KEY}" section.

If you do not have an API key and are part of an Enterprise or Partner plan, please contact MetroMap Support for the creation of the API key.

With the URL entered, change the item type to match the service you are wanting to connect to, being either "WMS (OGC)" or "WMTS (OGC)".

Item3.png

Upon successful connection to the service, you should now have access to the service's layer list. Due to the large number of layers available, it is recommended to use the search function to narrow down your options. For this screenshotted example the "Australia Latest" layer was found and selected.

Item4.png

In the last item creation page, you are able to manage the item including choosing its name, saved location, add tags, and add a description if desired. It is recommended to change the title to describe the service and layer if you are likely to create many items utilising MetroMap services.

Item5.png

Upon saving the item, you then have the option to be able to add it to a Map Viewer, Scene, or other environments that have access to ArcGIS Online items.

Item6.png

2. Map Viewer Setup

This method is for connecting directly to our services within a single ArcGIS Map Viewer session and loading an individual imagery layer. Images in this section are from the Classic version of the Map Viewer, however the method is similar for the regular Map Viewer.

First select the add drop down menu and then select the Add Layer from Web.

image.png

Choose between our WMTS or WMS OGC web services as both options are available here.

image.png

Once your preferred web service has been selected, create and input your URL. For this, refer to either WMS or WMTS for the correct URL format depending on which service you would like, and then embed your MetroMap API key within to replace the URL's "{YOUR-API-KEY}" section.

Click the layer drop down box and select your desired imagery. Once chosen click the Get Layers button.

image.png

Occasionally, the method above might not work successfully, therefore use the steps below:

image.png


3. Custom Tile Layer Setup

For this method, below is the URL to use (GetTile Request) which requires a valid API key. To utilise historical imagery here, you are welcome to change the layer parameter (LAYER=) response which will subsequently change the MetroMap capture layer, just make sure that your set tile coverage extent coincides with the chosen layer's coverage.

https://api.metromap.com.au/ogc/key/YOUR-API-KEY/service?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=Australia_latest&STYLE=&FORMAT=image/png&TILEMATRIXSET=webmercator&TILEMATRIX={level}&TILEROW={row}&TILECOL={col}

In your URL, the {level}, {row} and {col} are set by ArcGIS Online to fetch the correct tile, so these should not be changed.

Setting up the extent:


image.png
image.png
image.png

3. Scene Viewer Setup

  1. Log in to ArcGIS Online and navigate to content.
    image.png

  2. Fill out the following details, for the URL replace {YOUR_API_Key} with your key.
    Either
    https://api.metromap.com.au/ogc/key/{YOUR_API_KEY}/service?REQUEST=GetCapabilities&SERVICE=WMTS
    or
    https://api.metromap.com.au/ogc/gda2020/key/{YOUR_API_KEY}/service?REQUEST=GetCapabilities&SERVICE=WMTS
    image.png

  3. You should then be taken to a page displaying information about the newly created layer. Click "Open in Scene Viewer".
    image.png

    image.png

Back to Top


ArcMap 10.x

Setting up a WMS Service in ArcMap

image.png
image.png
image.png
image.png

In the Add WMS Server window, name your own connection, in the URL field,

Enter https://api.metromap.com.au/ogc/key/{YOUR_API_KEY}/service?REQUEST=GetCapabilities
Do not enter your User Name and Password.
image.png

image.png
image.png
image.png
image.png

To enable WMTS choose WMTS Servers from Add data menu and follow same steps as above. Please contact Aerometrex for the WMTS URL.


ArcGIS Earth

1. Open ArcGIS Earth and log in.

Click on the + sign in the top left-hand corner.

Screenshot 53.png

2. Adding either your WMS or WMTS URL

Once the menu appears select the Enter a URL Tab

ARCE 2.PNG

Click on Type.

This will provide a drop-down menu which will allow you to select either the WMS or WMTS service. Then enter your MetroMap URL with your API Key embedded within. Wait for your layer names to populate.

Finally select your desired Layers in the Name menu (we recommended using the Australia Latest layer). Then click ok.

MicrosoftTeams-image.png

ArcGIS Earth_wmts.PNG

Your chosen layer will now be uploaded and visible within your Table of Contents.

ARCE 4.PNG

Back to Top



What's Next