Customization properties table for Google Maps

  • Release version: Xanadu
  • 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 for Google Maps

    The customization properties for Google Maps enable users to tailor the map's functionality according to their specific needs and requirements. The properties allow for adjustments in authentication methods, display settings, and localization based on user data. These settings are crucial for ensuring effective integration with ServiceNow platforms.

    Show full answer Show less

    Key Features

    • Authentication Method: Choose between 'client-id' or 'key' for accessing Google Maps. Default is 'key'.
    • Auto Close Info Windows: Set google.maps.autoclose to true to automatically close the current info window before opening a new one.
    • Map Key: Utilize a Google Maps key for server URL access, with default value set. Ensure to obtain a key for geocoding requests.
    • Maximum Items Display: Control the number of items shown on the map with google.maps.maxitems; default is 500.
    • Map Table: The map requires a specific table format, with fields for Name, Longitude, and Latitude, defaulting to cmnlocation.
    • Geolocation Refresh Duration: Set the duration for refreshing longitude and latitude, ensuring it is below 30 days to comply with terms.
    • Localization: Enable map behavior alteration based on the user's country code, which should align with Google Map's region codes.

    Key Outcomes

    By effectively utilizing these customization properties, ServiceNow customers can enhance their mapping capabilities, ensure compliance with Google Maps' terms, and provide a more localized experience for users. This leads to improved data accuracy and user satisfaction when interacting with map functionalities 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