All pages
Powered by GitBook
1 of 5

Loading...

Loading...

Loading...

Loading...

Loading...

External Map Layers

Sensat

Nearmap

MetroMap

ArcGIS

Propeller

Civillo

DroneDeploy

Connect Propeller Layers

Things to know before you get started:

  • This feature is available on Pro+ or Enterprise plans

  • You need to be a Project Admin to set up the integration

If your team uses Propeller to capture drone surveys and aerial imagery, you can bring that same data into Aphex. The Propeller integration uses WMTS (Web Map Tile Service) to stream live site imagery directly onto your Map, so your team plans against the most current picture of the site, without anyone downloading or re-uploading a thing.

This guide walks you through how to generate a WMTS link in Propeller, add it to your project in Aphex, and set a Layer Policy to control what shows up.

Retrieving the WMTS Link


Propeller generates a unique WMTS link per site. You'll need this link to connect your survey imagery to Aphex.

To generate your WMTS link:

  • In Propeller, click your User Icon → WMTS and API

  • Click , give the link a clear name, and select the Site you want to connect

  • Click

  • Copy the generated link - this is the link you’ll use in Aphex


Once you’ve got your WMTS link handy, you can plug it into any real-world Location in your Project.

Visit our doc for step by step instructions on how to add layers to the Map.


When Aphex connects to your Propeller WMTS link, it detects all available survey sublayers for that site. A Layer Policy controls which of those sublayers are brought into your project, keeping things clean and relevant for your team.

Because Propeller WMTS links auto-update with each new survey upload, your Layer Policy also determines how Aphex handles those incoming datasets over time.

Visit our doc for step by step instructions on how to define a layer policy.


Propeller WMTS links update automatically each time a new survey is processed and published for your site. You don't need to regenerate the link or reconnect the layer in Aphex, new datasets will appear in line with your Layer Policy, with no action needed on your end.

Connect DroneDeploy Layers

Things to know before you get started:

  • This feature is available on Pro+ or Enterprise plans

  • You need to be a Project Admin to set up the integration

If your team uses DroneDeploy to capture drone imagery, you can stream those surveys directly into Aphex as a WMTS layer. This means your team plans against the most current aerial view of the site, without downloading or re-uploading a thing.

Retrieving the Layer URL


Each map layer in DroneDeploy has a unique WMTS URL. This is the URL you'll paste into Aphex.

You will need to have the ESRI integration included in your DroneDeploy subscription to access the WMTS URL. If you are unsure whether you have access, contact your DroneDeploy Customer Success Manager.

To retrieve the URL:

  • Log in to DroneDeploy and open your project

  • In the top navigation bar, select the Explore tab

  • Scroll to Apps + Integrations on the left side-panel

  • Expand the WMTS Integration section

  • Click Copy Link next to Map-Level WMTS - this is the URL you will paste into Aphex.

The DroneDeploy URL will follow a format similar to this:


Once you’ve got your Layer URL handy, you can plug it into any real-world Location in your Project.

Visit our doc for step by step instructions on how to add layers to the Map.


Once your DroneDeploy layer is connected, a Layer Policy controls which sublayers appear in Aphex and how new ones are handled as fresh surveys are uploaded to DroneDeploy.

Visit our doc for step by step instructions on how to define a layer policy.

WMTS is a paid-premium feature in Propeller. Check with your Propeller Customer Success Engineer if you're unsure whether your account has access

Propeller WMTS links don't require a username or password, anyone with the link can access your survey imagery. Only share them with trusted teammates, and avoid sending them over email or messaging apps where possible.

Each link is unique. If a link is shared accidentally, you can delete it from WMTS and API settings in Propeller to instantly revoke access.

Add the Layer to Your Aphex Map

Set a Layer Policy

Most Recent is usually the best starting point for Propeller surveys. It keeps your map current without pulling in every historical dataset.

How Auto-Updates Work

Add Map Layers
Layer Policies

You will need to have the ESRI integration included in your DroneDeploy subscription to use this feature. If you are unsure whether you have access, contact your DroneDeploy Customer Success Manager.

https://www.dronedeploy.com/api/v1/wmts/plan/{plan-id}?jwttoken={token}

Add Layers to the Map

Set a Layer Policy

Most Recent is usually the best starting point for drone survey layers, it keeps your map showing the latest capture without loading every historical flight.

Add Map Layers
Layer Policies

Connect Civillo Layers

Things to know before you get started:

  • This feature is available on Pro+ or Enterprise plans

  • You need to be a Project Admin to set up the integration

If your team uses Civillo to manage geospatial data (utilities, design models, boundaries, work zones, and permits) you can bring those same layers directly into Aphex. The Civillo integration lets your site teams access up-to-date spatial context right alongside their short-range plan, without switching between systems.

This guide walks you through how to retrieve your Layer URL from Civillo, add it to your project in Aphex, and set a Layer Policy where applicable.

Publishing the Layer in Civillo


WMTS is a paid-premium feature in Civillo. Check with your Civillo Customer Success Manager if you're unsure whether your account has access.

Initiate the Publishing Process

  1. Navigate to your project space in Civillo and select the desired layer you wish to publish.

  2. From the selected layer's view, click the three-bar menu to access the admin view.

  3. Go to Administration > Layers > Edit.

  4. Scroll to the bottom of the page to find the Published Layer box.

  5. Click the box to initiate the publishing process.

After you trigger the publishing process, you'll receive an email notification that is essential for accessing your published layers:

  • Locate the email from Civillo that confirms the layer publishing has started.

  • This email contains a direct link to the project's publishing page. This link is important because the publishing area can be difficult to access through standard navigation.

  • Save or bookmark this URL for future use. The page provides a summary of all published layers within your project.


Once you have published the layer, you will be able to copy the layer URL to paste into Aphex. All Civillo layer URLs are accessed through your Civillo Publish portal.

Navigate to your project, then choose the service type you need. Civillo exposes its geospatial data through two service types that Aphex supports:

Service Type
Description
  • Log in to your Civillo Publish portal and open your project

  • Click ESRI Tile Service. This opens the ArcGIS REST Services Directory, listing all available layers with their service name and code

  • Locate your layer by name, then click into it to open the layer detail page

A Civillo Vector Tile URL will appear in a format similar to the below;

  • Log in to your Civillo Publish portal and open your project

  • Click Web Map Tile Service. This opens a list of available imagery datasets for the project

  • Click in the top-right corner

A Civillo WMTS URL will appear in a format similar to the below;


Once you’ve got your Layer URL handy, you can plug it into any real-world Location in your Project.

Visit our doc for step by step instructions on how to add layers to the Map.


Layer Policies apply to Civillo WMTS layers and control which sublayers are brought into your project. They do not apply to ESRI Vector Tile Service layers.

Visit our doc for step by step instructions on how to define a layer policy.

Click in the top-right corner to view the layer in JSON format
  • Copy the url value. This is the Layer URL you'll use in Aphex

  • Copy the URL from your browser's address bar. This is your WMTS Capabilities URL

    Aphex supports two Civillo layer types: ESRI Vector Tile Service and WMTS

  • WMTS is a paid-premium feature in Civillo. Check with your Civillo Customer Success Manager if you're unsure whether your account has access.

  • ESRI Vector Tile Service

    Vector data including design models, utilities, boundaries, and work zones. These layers do not require credentials in Aphex and connect directly without a login. Layer Policy and Quantity options are not available for this layer type.

    Web Map Tile Service

    Pre-rendered raster imagery such as aerial photography. These layers follow the same rules as other WMTS connections in Aphex, including Layer Policy support.

    https://pub.civillo.com/<id>/<id>/arcgis/rest/services/<layer-code>/VectorTileServer
    https://pub.civillo.com/<project-id>/wmts/WMTSCapabilities.xml

    Access the Published Layers

    Retrieving the Layer URL

    To retrieve your Vector Tile Layer URL:

    To retrieve your WMTS URL:

    Adding Layers to the Map

    Vector Tile layers connect without credentials - you won't be prompted to log in and no Layer Policy options will appear. WMTS layers may prompt you to select credentials if the layer requires authentication, and support Layer Policy configuration.

    Setting a Layer Policy (WMTS Only)

    Add Map Layers
    Layer Policies

    Connect ArcGIS Layers

    Things to know before you get started:

    • This feature is available on Pro+ or Enterprise plans

    • You need to be a Project Admin to set up the integration

    If your team uses ArcGIS to manage design context, utilities, exclusion zones, or aerial imagery, you can bring that same data into Aphex. The ArcGIS integration allows you to overlay live GIS layers directly onto your Map, so that short-term planning happens with real site context in view.

    This guide walks you through how to connect your ArcGIS account, find the correct URL for your layer, add it to your project in Aphex, and manage the integration moving forward.

    Supported ArcGIS Layer Types


    Aphex supports a range of commonly used ArcGIS layer types. Here’s what you can connect and display in your project. We’ll keep this list updated as more are added:

    Feature Layers

    Map Image Layers

    Tile Layers (Raster and Vector)


    To connect a layer to Aphex, you’ll need the page URL from the ArcGIS Item Details page. This makes sure the layer metadata and access permissions load correctly.

    • Login to your ArcGIS instance

    • Navigate to the layer you want to connect to your Aphex Project

    • Make sure the layer is one of the supported layer types

    • Click into the layer to open the

    The ArcGIS Item Details URL will commonly appear in a format similar to the below;


    You can connect your ArcGIS account to Aphex using either your ArcGIS login credentials or a . Once linked, you’ll be able to access and validate layers tied to your connected ArcGIS account.

    • Open your Aphex Project

    • Click your Project Title in the top left then select Integrations

    • Scroll to the Mapping Connection section


    Once you’ve got your Layer URL handy, you can plug it into any real-world Location in your Project. After connecting it, set a Layer Policy to control exactly which sublayers show up in Aphex, keeping things neat and relevant for your team.

    Aphex will then automatically pull through any updates from ArcGIS, so your map stays fresh without you needing to re-upload or re-import a thing.

    Both private and public layer sources from can be used as a canvas for mapping in Aphex. Each Aphex Location will accept up to 20 different layer connections.

    Visit our doc for step by step instructions on how to add layers to the Map and define a layer policy.


    Aphex supports layers being connected from any ArcGIS service (Online or Enterprise); however, there are some common things to validate if you experience issues;

    Check that the ArcGIS user or app you’re using has permission to view the layer. Try logging into ArcGIS directly and opening the layer using the same credentials - if it works there, it should work in Aphex.

    By default, ArcGIS allows CORS - meaning external services like Aphex can, with the appropriate credentials, view resources such as layers. However, some GIS administrators may disallow this feature as an added security feature.

    If you find that a layer connects successfully, but no data is visible on the map, it may be a result of the ArcGIS CORS policy at your company.

    ArcGIS supports CORS access enabled, disabled, or disabled with exceptions. Therefore you can either ask your GIS administrator to return the CORS policy to default enabled or to add the following domains as CORS exceptions;

    • https://app.aphex.co

    • https://dev.aphex.co

    For guides on adjusting the ArcGIS CORS policy, please refer to the ArcGIS Help Guide .

    Make sure you're using the Item Details page URL (not the direct tile or REST endpoint). Only supported layer types (listed above) will load.


    Aphex is designed to be as fast and lightweight as possible for users who could be accessing their project on poor connections or underpowered devices.

    ArcGIS, however, is a powerful GIS service that allows its customers to create immense geographical datasets.

    Connecting an ArcGIS layer to Aphex will allow that layer to be loaded to an almost identical way to the way that layer is loaded from ESRI services.

    To keep load times as short as possible, each sublayer within a layer can be set to Hide or Show, depending on the context needed at the time.

    There is currently a limit of 42 sublayers per layer - any sublayers that attempt to load past this amount will not render.

    Therefore, teams creating layers for use in Aphex should seek to balance information and end-user performance. The more data that is included in a layer, the longer it will take to load for everyone.


    For ArcGIS Map Service Layers (Raster Tile Layers & Map Image Layers) you have the ability to change the request mode, once the Layer has been connected to your Aphex Location, to reduce server requests.

    • Open your Aphex Project

    • Click your Project Title in the top left then select Locations

    • Locate your Layer and click ...

    This mode is set on a layer-by-layer basis.

    Item Details Page
  • Copy the URL from your browser’s address bar - this is the URL you’ll use in Aphex

  • Click and select from:

    • Registered User

    • Registered App (Client ID and Client Secret - OAuth2)

  • Select

  • Select View Summary and scroll to the Minimise Server Requests section. Make a choice between:

    • Optimised (default)

    • Reduce Server Requests

  • Click

  • Aphex supports layers being connected from any ArcGIS service (Online or Enterprise)

    https://<your-source>.maps.arcgis.com/home/item.html?id=<id>
    Maximise Layer Loading Performance

    Layer Type: Tiled or raster image layer types generally load faster than feature layers. This is especially true for layers with many strings (lines), such as design alignments. Where possible, seek to publish layers with these types;

    Layer Type
    Best Use

    Server Selection: If your company can publish layers to an Enterprise or ArcGIS online server, there is usually a performance difference across those. Whichever is faster for loading layers in the ESRI service will be faster in Aphex.

    Retrieving the Layer URL

    To find the Layer URL:

    Connect your ArcGIS account to Aphex

    To add your ArcGIS credentials into Aphex:

    Registered User vs Registered App

    You can connect private ArcGIS layers to Aphex using either a registered user account or a registered app (OAuth2.0). Both options work, but the app connection is more flexible if you're managing access across multiple projects.

    Using a registered app allows you to control exactly which layers projects can access, without relying on a single user having access to everything. This is especially useful if your Organisation needs to manage permissions per project or restrict access to sensitive layers.

    With a registered user, that user account must have access to every layer being connected - which can get messy across teams or projects. Apps make it easier to scale securely.

    Add Layers to the Map

    Common Connection Errors

    Credentials do not have Layer Access

    If you are using a Registered User account for access, you can test the access level of that account by simply logging into your ESRI/ArcGIS account and attempting to open the layer you want to integrate. If you can open a layer in ArcGIS, your account has permission to view it.

    Example Errors

    "Failed to connect to your ArcGIS Instance

    Please check your login credentials and try again or speak to your ArcGIS admin"

    Cross-Origin Resource Sharing (CORS) Restrictions

    Example Errors

    Error inside the Add Layer window:

    "Url Error - Please check the url is correct and that the server is configured to allow requests from app.aphex.co"

    Error inside the Browser Developer Console:

    Access to '<layer url>' from origin 'https://app.aphex.co' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

    Unsupported Layer Type or Invalid URL

    Example Errors

    "Url Error - Please check the url is correct and that the server is configured to allow requests from app.aphex.co"

    Layer Performance Tips

    In general, Aphex should take as long to load a layer as it takes ArcGIS to load the same layer. You can test the expected load time for your users by opening a layer natively in ArcGIS first.

    Reduce Server Requests (Low Data Mode)

    To switch to Low Data Mode:

    registered app
    ESRI ArcGIS
    Add Map Layers
    here

    Map Image Layers

    Designs, utilities, alignments. Anything that is suited to a feature layer will perform well in Aphex as a Map Image.

    Tile Users

    Drone or other aerial imagery are often already stored as tile layers and perform well. If your company's ESRI account doesn't support this, Map Image will work, too.