Customization properties table for Google Maps

  • Release version: Yokohama
  • 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 enable users to tailor the map's functionality and behavior according to their needs. This includes authentication methods, info window management, and localization based on user settings.

    Show full answer Show less

    Key Features

    • Authentication Method: Configure the authentication method using either a client ID or a key (default is key).
    • Info Window Management: Control the opening behavior of info windows with the autoclose property, allowing for either single or multiple windows.
    • Geocoding Key: Set a Google Maps key for geocoding requests; a customer-provided key is necessary for functionality.
    • Map Item Limits: Specify the maximum number of items to display on the map, with a default limit of 500.
    • Data Source Table: Define the table used for mapping, which must include specific fields like Name, Longitude, and Latitude (default is cmnlocation).
    • Google Maps Version: Manage the version of Google Maps in use (default is 3.37).
    • Location Refresh Duration: Set the duration for refreshing longitude and latitude data, ensuring it stays within Google’s terms of service (default is 28 days).
    • Localization: Enable region-based behavior adjustments based on the user's country code from the sysuser record.

    Key Outcomes

    By utilizing these customization properties, ServiceNow customers can enhance their mapping experience, ensuring it is aligned with their organizational requirements and compliant with Google’s policies. This leads to improved data accuracy and user interaction with maps tailored specifically for their operational needs.

    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