Ctrlk
Trust CentreRoadmapStatusLogin
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Export as PDF

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

  • 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.

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.

Access the Published Layers

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.

Retrieving the Layer URL

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

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.

To retrieve your Vector Tile Layer URL:

  • 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

  • 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

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

To retrieve your WMTS URL:

  • 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

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

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

Adding Layers to the Map

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

Visit our Add Map Layers doc for step by step instructions on how to add 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)

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 Layer Policies doc for step by step instructions on how to define a layer policy.

Last updated

Was this helpful?