Starting with version 2019r2, ArcGIS Online service credits will be required to perform certain tasks when the Esri World Geocoding Service has been set as the system default geocoding service within Lucity.
There are many tools, services, and applications provided with Lucity that use a geocoding service. Some of these tools will take the results of the geocoding service and store them in the Lucity database. It is this action, saving the results of the Esri World Geocoding Service to the Lucity database, that will start using your ArcGIS Online service credits. As of 2019r2, the following are the two tools that have the potential to use credits:
Lucity Spatial
Lucity offers the ability to store work and inspection spatial components directly in the Lucity database. Storing the spatial component (geometry) in the Lucity database allows for faster analysis, better efficiency, and more flexibility when showing these locations in a map. As records are created, updated, and deleted in Lucity, a Lucity service processes the changes and adds the spatial location (geometry) directly in the Lucity database. It is during this process, and specifically when calculating the spatial location of an address, that the default geocoding service is used. The process uses the geocoding service to calculate the xy for a given address and the result (xy) is then stored within the Lucity database. This is considered a paid operation and will require the use of ArcGIS Online service credits if using the Esri World Geocoding Service.
GIS Scheduled Tasks
Scheduled Tasks provide the ability to automatically sync data between your GIS and Lucity products. One of the options when configuration your GIS Scheduled Task is to enable spatial relates for imports. There is one type of spatial relate that will require the use of ArcGIS Online service credits, the Reverse Geocode. The Reverse Geocode spatial relate type uses the geocoding service to calculate the address associated with the location of the GIS asset and the result (address) is then stored within the Lucity database. This is considered a paid operation and will require the use of ArcGIS Online service credits if using the Esri World Geocoding Service.
As part of this change, starting with version 2019r2, we no longer use the Esri World Geocoding Service if a default geocoding service has not been defined in Lucity. The following is a list of Lucity tools that require the use of a geocoding service and will no longer work with version 2019r2 if there is not a default geocoding service defined within Lucity:
Webmap
Load Address Subset
Show in Map
Point Location tool
Find Address tool
Spatial Updater
GIS Scheduled Tasks
Export tasks
Import tasks that use the reverse geocode spatial relates
Work Maintenance/Alternate Zones
Is my organization impacted by this change?
Use the following questions to help you determine if this change will affect you or not. Directions for looking up the answer to each question are found below.
Do you have a Lucity system default geocoding service defined, and is it the Esri World Geocoding Service?
No. Since you are not using the Esri World Geocoding Service as the system default this change will not impact your process and no further action is required on your part.
Yes. This change has the potential to impact your organization. If you would like to continue to use the Esri World Geocoding Service as the system default in Lucity proceed with answering the following questions; otherwise, you will need to switch the Lucity system default geocoding service to something other than the Esri World Geocoding Service. You can find information on creating your own geocoding service here.
Has Lucity Spatial has been enabled?
Do you have any GIS Scheduled Tasks that have the Enable Spatial Relates options checked AND the layer configuration has a Reverse Geocode spatial relationship defined?
Did you answer yes to #2 or #3 above?
No. Although the Esri World Geocoding Service has been configured as the system default within Lucity, your organization is not currently using any tools that would require the use of service credits. This change will not impact your current process and no further action is required on your part at this time. However, you need to be aware that changes to your current process and/or changes to existing tools or future Lucity tools may trigger the use of service credits. It is recommended that you go ahead at this time and configure Lucity to use the Esri World Geocoding Service and consider the option to monitor credit usage in ArcGIS Online.
Yes. The Esri World Geocoding Service has been configured as the system default within Lucity and your organization is currently using a tool that requires the use of service credits. You will need to follow the instructions to configure Lucity to use the Esri World Geocoding Service and consider the option to monitor credit usage in ArcGIS Online.
Do you have a Lucity system default geocoding service defined, and is it the Esri World Geocoding Service?
In the Lucity Administration tool, go to GIS>>GIS Services…
On the GIS Services dialog, navigate to the second tab, Utility Services.
On the Utility Services tab, under the Geocoding Services section, there will a dropdown populated with the current Default Geocoding Service. Note: if you do not have a default geocoding service defined now is a good time to set one! There are many Lucity tools that utilize a geocoding service that will no longer work at 2019r2 without having a default specified.
Find the geocoding service record with the same name as the system default from the previous step.
Since the name of the service is user defined, you need to examine the url of the service to determine if it is indeed referencing the Esri World Geocoding Service. The Esri World Geocoding Service url is: https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer (or http).
2 - Has Lucity Spatial been enabled?
In Lucity web, open the Admin Portal
In the Admin Portal, click Settings>>System Settings
In System Settings, change the dropdown to GIS
Check the value for the Lucity Spatial- Enabled setting. If set to TRUE, then Lucity Spatial has been enabled.
3 - Do you have any GIS Scheduled Tasks that have the Enabled Spatial Relates option checked AND the layer configuration has a Reverse Geocode spatial relationship defined?
Depending on your Lucity GIS integration you will either use the Geodatabase Configuration tool in ArcCatalog or the GIS Configuration tool in Lucity Administration tool to determine if you are using reverse geocode spatial relates with your GIS Scheduled Tasks. Alternatively, you could run a query against your Lucity database to determine the answer.
Using the Geodatabase Configuration tool, you can manually examine each layer configuration to see if it contains a Reverse Geocode spatial relationship AND it contains a GIS Scheduled Task that has the Enable Spatial Relates option checked. The following is a screenshot showing an example of a layer (pkTree) that meets the criteria:
Alternatively, the following is a query you could run against your Lucity database to determine if you have any layers that meet the criteria. It will return a list of GIS Scheduled Task records that are configured to use reverse geocode spatial relationships.
SELECT * FROM CMGISTASKS WHERE TK_GL_ID IN (SELECT DISTINCT ASL_GL_ID FROM CMGISSREL WHERE ASL_R_TYPE = 11)
