Customization properties table for Google Maps

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Customization Properties Table for Google Maps

    The customization properties for Google Maps allow ServiceNow customers to configure how Google Maps integrates with their applications. This includes authentication methods, display settings, and regional behavior adjustments. Understanding these properties is essential for optimizing the use of Google Maps within your ServiceNow environment.

    Show full answer Show less

    Key Features

    • Authentication Methods: Choose between 'client-id' or 'key' for authentication with a default value of 'Key'.
    • Info Window Management: Set google.maps.autoclose to true to automatically close the current info window before opening a new one.
    • Map Keys: Utilize google.maps.key and google.maps.client for accessing Google Maps services, with specific instructions for obtaining these keys.
    • Geocoding Requests: Use google.maps.key.geocoding for geocoding purposes, with a default value of none.
    • Item Display Limit: Control the maximum number of items displayed on the map with google.maps.maxitems, defaulting to 500.
    • Location Data Table: Specify the table used to map locations, requiring fields for Name, Longitude, and Latitude.
    • Version Control: Specify the Google Maps version via google.maps.version, defaulting to 3.37.
    • Location Refresh Duration: Set google.maps.refresh.latlong.duration to less than 30 days to comply with Google Maps terms.
    • Regional Behavior: Enable google.maps.localization.region.enable to customize map behavior based on user location.

    Key Outcomes

    By properly configuring these customization properties, ServiceNow customers can enhance their mapping functionalities, ensure compliance with Google’s usage terms, and tailor the user experience based on geographic settings. This ultimately leads to improved operational efficiency and user satisfaction within their applications.

    Customization properties for Google Maps are explained in the Google Maps Properties table.

    Table 1. Customization properties for Google Maps
    Name of the customization property Description
    Defines which method of authentication should be used for Google Maps

    google.maps.method

    Note:
    The "Name of the customization property" column refers to the customization properties mentioned in the Customization properties for Google Maps topic.
    • Type: choice list (client-id,key)
    • Default value: Key
    If true, automatically closes the current "info window" before opening a new one. If false, you can have multiple "info windows" open.

    google.maps.auto_close
    • Type: yes or no
    • If set to True, automatically closes the current info window before opening a new window.
    Map key from Google, tied to the URL of the server. To obtain a new key, visit http://www.google.com/apis/maps/signup.html for details.

    google.maps.key
    Note:
    The Fam-map component uses the key (google.maps.key) and client ID (google.maps.client) set for the authentication. You must use one of the options: either the key or client-ID.
    Client ID for Google Maps API for Business. To obtain your own key, visit http://www.google.com/enterprise/earthmaps/maps.html for details.

    google.maps.client
    • Map key from Google, tied to the URL of the server.
    • Default value: gme-servicenow
    Customer provided Google Maps key used for geocoding requests. To get the key, see https://developers.google.com/maps/documentation/geocoding/get-api-key

    google.maps.key.geocoding
    • Google Maps key used for geocoding requests.
    • Default value: None
    Maximum number of items to display on the map

    google.maps.max_items
    • Maximum number of items to display on the map.
    • Default value: 500
    Table used by the map. The table requires the fields: Name, Longitude, Latitude.

    google.maps.table
    • Table used by the map.
    • Default value: cmn_location
    Google Maps Version

    google.maps.version
    • Google Maps Version
    • Default value: 3.37
    Duration in the number of days. It is used while refreshing the longitude and latitude of a location saved in the system. Storing them beyond 30 days time period violates the Google maps terms and conditions. Verify that it is always set to a value less than 30.

    google.maps.refresh.latlong.duration
    • Duration in the number of days.
    • Default value: 28
    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.

    google.maps.localization.region.enable
    • Enable this property when you want to alter the Google Map's behavior based on a region.
    • Type: yes or no