How to setup and use Apple Maps in Incorta?
Incorta 4.1 and above supports using Apple Maps inside your Dashboards/Reports.
This article explains how to setup, and use Apple Maps in Incorta insights.
Incorta integrates with Apple Maps using the mapkit JS APis. To setup Apple Maps integration, please follow these steps:
1) Login to Incorta Admin page using the System Admin credentials. The URL should be like https://HOSTNAME:SSL_PORT/incorta/admin, e.g. https://localhost:8443/incorta/admin.
2) Click on Tenants tab:
3) Click on your tenant name:
4) Go to the "Integration" section.
5) Enter the following three Apple mapkit JS paramaters.
Note that Apple Maps API key file (.p8), you need to paste everything that appears between "---- BEGIN PRIVATE KEY ---- " and " ---- END PRIVATE KEY ----" in the *.p8 key file.
6) Press "Save", no restart is required.
Now to use Apple Maps in an insight, simply pull in the Address (Or lat/long) column in a maps chart:
a) Select the Maps Visualization:
b) Add an Address (lat/long) to the group by section , and an attribute to the measure section:
NOTE/WARNING: currently our Analyzer page is still using the older UI/UX, so AppleMaps does not render in the Analyzer page, you instead see the message printed "Sorry, Apple Maps are not Supported". Once you press Done to save the dashboard, Apple Maps will render the dashboard appropriately. We apologize in advance for this confusion.
c) Click on the "downward carat/arrow" symbol on the Address ("Address Line 1" in screenshot above), and click on the scrollbar icon shown below.
d) Select Apple Maps Address, press Done to save the Dashboard.
All address data will now be shown in Apple Maps: