---
sourceDocument: Australia ServiceNow AI Platform user interface
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/platform-user-interface

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Set up Google Maps API

# Set up Google Maps API {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

You enable the geolocation feature using the appropriate entries from a Google Maps API for Business license, or a Google Maps
JavaScript API Key.

## Antes de Iniciar

Role required: admin

## Por Que e Quando Desempenhar Esta Tarefa

You can generate maps using basic JavaScript, and they are flexible enough to display even the most complicated of queries. These maps use standard Google Maps API for Business or Google Maps JavaScript API Key mapping features, including various link types to records in your instance. Use of this feature requires installation of the Google Maps plugin.  
Figura 1. Map page  
Importante:  
Starting May 2026, Google is deprecating the use of Client ID for authenticating requests to Google Maps. From this date onward, API keys will be the only supported authentication method. If your application continues to use client-id (for example, via the google.maps.method property), Google Maps requests will fail. For more information, see [Client ID Migration Guide](https://developers.google.com/maps/premium/migrate-client-id).

Update your configuration to authenticate using an API key only (that is, set google.maps.method to <kbd class="ph userinput">key</kbd>). Refer to the
descriptions of google.maps.key and google.maps.key.geocoding properties for more information on API key--based authentication.

## Procedimento

1. Google Maps APIs for Business licenses are no longer available from Google, so, depending on whether have an existing license, use one of the following procedures.  
   Nota:  
   You are required to use your own Google Maps JavaScript API Key from Google and not use any ServiceNow AI Platform® generated key.

   | Existing Google Maps API for Business license available? | Tasks |
   | Existing license available | 1. In the System PropertiesGoogle Maps property form: * In the google.maps.client field,enter the Client ID for your organization. This ID is from Google and starts with `gme-`, such as `gme-mycompanyname`. * In the google.maps.client.key field, enter the private key for Google Maps API for Business. An example of an encoded key is `vNIXE0xscrmjlyV-12Nj_BvUPaw=`. The ServiceNow AI Platform® requires this key to retrieve accurate driving time estimates from Google for some Geolocation features. * Fill out the remaining values on the form. {#set-up-google-maps-api__ul_wxf_1sj_smb} 2. Configure your maps using the property definitions from the table. {#set-up-google-maps-api__ol_hqp_wnj_smb} Importante: The Google Maps Client ID--based configuration is being deprecated. Client ID authentication will not be supported starting May 2026, and configurations relying on it will no longer work. |
   | No license available | 1. Obtain a Google Maps JavaScript API Key from Google. 2. In the System PropertiesGoogle Maps property form, enter the API key into the google.maps.key field. Geolocation in the ServiceNow AI Platform® uses the API Key, which Google Maps also uses for Geolocation and map view billings. 3. Fill out the remaining values on the form. 4. Configure your maps using the property definitions from the table. {#set-up-google-maps-api__ol_qnd_vpj_smb} |
   |-|-|

   {#set-up-google-maps-api__choicetable_okq_vnj_smb}  
   To learn more about Google Maps API for Business, and Google Maps JavaScript API Key, see <https://developers.google.com/maps/gmp-get-started>.
2. After you complete and save the configuration, create Map pages, or use the default pages included with the plugin.  
   Map pages define what data appears on the map, and the appearance of the links. For a tutorial on how to view all of the markers that link to your records, see the [Display Map Markers on Google Maps](https://community.servicenow.com/community?id=community_blog&sys_id=909ceae1dbd0dbc01dcaf3231f96192b) blog post on the ServiceNow Community.  
   {#set-up-google-maps-api__table_edd_4zf_vt__entry__2}

   | Property | Description |
   |-|-|
   | google.maps.method | Defines which method of authentication should be used for Google Maps. * Type: string * Default value: key * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_td5_zx2_m3c} |
   | google.maps.auto_close | If true, automatically closes a map information window before opening a new one. * Type: true/false * Default value: true * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_zb5_slr_bq} |
   | google.maps.client | Client ID for Google Maps API for Business. * Type: string * Default value: gme-servicenow * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_pyj_ylr_bq} |
   | google.maps.map_id | Map ID for Google Maps used for the cloud-based maps styling, vector maps, and advanced markers. To obtain your Map ID, see [How to create map IDs](http://developers.google.com/maps/documentation/javascript/map-ids/get-map-id). * Type: string * Default value: empty * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_izr_qn2_m3c} |
   | google.maps.client.key | Private key for Google Maps API for Business. This key activates the geolocation feature, which locates users in the system precisely, using data from their mobile devices. * Type: string * Default value: empty * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_j1k_zlr_bq} |
   | google.maps.version | Version number of the current installation of Google Maps API for Business. * Type: string * Default value: current version number * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_acs_zlr_bq} |
   | google.maps.key | Google Maps API for Business or Google Maps JavaScript API Key that ties to the URL of the server. This key authorizes development use of Google Maps API. * Type: string * Default value: empty * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_zsx_zlr_bq} |
   | google.maps.key.geocoding | Google Maps API for business or Google Maps JavaScript API key that ties to the URL of the server. This key is used for making geocoding requests. * Type: string * Default value: empty * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_drh_fy2_m3c} |
   | google.maps.latitude | Starting latitude of the map. This value determines the starting position displayed in Google Maps. * Type: string * Default value: 36.008522 * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_qvc_1mr_bq} |
   | google.maps.longitude | Starting longitude of the map. This value determines the starting position displayed in Google Maps pages. * Type: string * Default value: -95.221764 * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_pbp_1mr_bq} |
   | google.maps.max_items | Maximum number of items to display on the map. * Type: integer * Default value: 500 * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_lgy_1mr_bq} |
   | google.maps.table | Table used by the map. The table needs the following fields: name, longitude, latitude. * Type: string * Default value: cmn_location * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_xyd_bmr_bq} |
   | google.maps.zoom | Starting zoom level of the map (1 is the lowest) * Type: string * Default value: 4 * Location: System PropertiesGoogle Maps {#set-up-google-maps-api__ul_tys_bmr_bq} |
   [ ]

   {#set-up-google-maps-api__table_edd_4zf_vt}
3. Perform these configurations:
   1. Navigate to System PropertiesAll.
   2. Set values for these system properties:  
      {#set-up-google-maps-api__table_dww_kh2_r4b__entry__2}

      | System property | Description |
      |-|-|
      | google.maps.refresh.latlong.duration | Number of days after which the location details are updated. Nota: The maximum value is 30. |
      | google.maps.refresh.latlong.record_count_per_table | Maximum number of records in a table that can be processed using the scheduled job in one refresh. |
      [ ]

      {#set-up-google-maps-api__table_dww_kh2_r4b}
   3. Specify the tables that store the location details in the Map Coordinates Refresh Configuration \[cmn_coordinate_refresh_config\] table.
   4. If there are no fields to track when the coordinates are last retrieved in your tables:  
      1. Create the coordinates_retrieved_on field of the type Date/Time in your tables.
      2. Ensure that the value of the field that tracks time when the coordinates are last retrieved, is populated correctly in the Map Coordinates Refresh Configuration \[cmn_coordinate_refresh_config\] table. Refer to the sample fix script Update coordinates updated on field to update values in the coordinates_retrieved_on field.
      {#set-up-google-maps-api__ol_rt4_m32_r4b}
   5. Navigate to System DefinitionScheduled Jobs.
   6. Open the record, Refresh Latitude Longitude info of Records.
   7. Select the Active check box.
   8. Specify the frequency at which the location details should be refreshed by providing frequency details in Run and Repeat Interval.  
      Nota:  
      Ensure that you refresh the location details at least once every 30 days.
   {#set-up-google-maps-api__substeps_fqt_gh2_r4b}
4. **Opcional:** To access Google Maps from the ServiceNow instance based on your region, perform these configurations.
   1. Navigate to User AdministrationUsers.
   2. Select and assign the relevant Country Code for the required user.  
      Nota:  
      If the required Country Code isn't available, add the dictionary entry. Ensure that you use the ISO 3166-1 country codes. For example, the country code of Morocco is <kbd class="ph userinput">MA</kbd>.
   3. Navigate to System PropertiesGoogle Maps.
   4. Select the Yes check box for Enable this property only when you want to alter the Google map's behavior based on a region. The region is populated from the current User's 'Country code' field value in sys_user record. The Country code value on the sys_user record should be consistent with the expectations from the Google Map's region code. Most Unicode region identifiers are identical to ISO 3166-1 codes, with some notable exceptions. Check the codes properly before making any changes.
   5. Click Save.
   {#set-up-google-maps-api__substeps_xs5_vk5_kqb}
**Tarefas relacionadas**   

* [Create a map page](https://servicenow-prod.fluidtopics.net/83D2ScX1f~5Ay3QHC9PuAg "Your ServiceNow instance provides several default map pages. You can also create custom map pages with the script examples described in this page.")
* [Create a map page module](https://servicenow-prod.fluidtopics.net/Jx4E64Y89ep8AfoJuJ5OyA "You can create a new application module for desktop or smartphone users to display a Google map page.")
* [Create an advanced Map Page](https://servicenow-prod.fluidtopics.net/vxOI1vwhqeeuOGw0dqYBUg "Use advanced configuration to set up Map Pages without scripting.")
* [Set map application scope](https://servicenow-prod.fluidtopics.net/Qc9PNPSSIj0KZC~4mIWt6w "Enable map application scope to specify which application can modify your Map Page configuration.")
* [Create a smartphone map page module](https://servicenow-prod.fluidtopics.net/ZEGE6Mg97pvSBYaB2mWGQA "You can create a custom smartphone module that links directly to a map page.")  
**Referência relacionada**   

* [Scripting for map pages](https://servicenow-prod.fluidtopics.net/Y6YlYCRw8Wqp41rfEsI9kA "The Script field on the Map Page form allows the use of attributes or custom code to define map characteristics, such as marker appearance, display information, and more.")