Customization properties table for Google Maps

  • Release version: Zurich
  • Updated July 31, 2025
  • 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 their maps effectively. This includes selecting authentication methods, managing info windows, and setting limits on displayed items. Understanding these properties helps optimize map functionality within your applications.

    Show full answer Show less

    Key Features

    • Authentication Method: Choose between client ID and key for Google Maps access (default: Key).
    • Info Window Management: Control whether to auto-close the current info window (google.maps.autoclose) when opening a new one (default: false).
    • Map Key: Use a customer-provided Google Maps key for geocoding requests (google.maps.key.geocoding) with a default of None.
    • Maximum Items Display: Set the maximum number of items to show on the map (default: 500).
    • Localization: Enable region-based behavior adjustments based on the user's country code (google.maps.localization.region.enable).
    • Refresh Duration: Define the duration for refreshing longitude and latitude, set to less than 30 days to comply with Google’s terms (default: 28 days).

    Key Outcomes

    By configuring these properties, ServiceNow customers can enhance their map experiences, ensuring compliance with Google Maps guidelines while optimizing user interaction. Proper setup leads to improved performance and relevance of displayed data on maps.

    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