Using geolocation in Virtual Agent

  • 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 Using geolocation in Virtual Agent

    The Geolocation topic block in ServiceNow's Virtual Agent enables topic authors to incorporate location-based functionality into conversations by retrieving a user's latitude and longitude coordinates with their permission. This capability helps deliver faster, more efficient responses, such as dispatching nearby technicians to customer sites, by leveraging the user's real-time location data.

    Show full answer Show less

    Key Features

    • User Permission Request: When the Geolocation topic block is used, users are prompted to grant permission for location sharing. Based on their response, the system either retrieves coordinates or displays an error message.
    • Customizable Conversation Flow: Topic authors and admins can duplicate and modify the Geolocation block to tailor the prompt wording and behavior using input mappings, data pills, and scripts within the Virtual Agent Designer.
    • Input and Output Mappings: Authors can customize how the Virtual Agent asks for location access and specify which output variables to capture, such as latitude, longitude, error messages, and status details. These variables are stored on the server and used in the conversation.

    Practical Application for ServiceNow Customers

    By integrating the Geolocation topic block, customers can enhance service interactions that require location awareness. For example, when managing incidents that need on-site resolution, knowing a user's location allows dispatching the most appropriate technician nearby, improving response times and customer satisfaction.

    Additionally, the ability to customize prompts and handle errors ensures a smoother user experience and easier troubleshooting for topic authors. Selecting relevant output variables helps track and resolve issues if location data is unavailable.

    Topic authors can include a pre-built topic block called Geolocation in conversations with users. The Geolocation topic block retrieves the latitude and longitude coordinates of the user's location.

    Topic authors can add this topic block to larger conversation flows. With the user's permission, the topic block retrieves the user's latitude and longitude location coordinates. Knowing these coordinates can help topic authors respond to customer requests or issues faster and more efficiently.

    For example, you may need to send a technician to a customer site to resolve an incident. To quickly respond to the customer, you need to know which technicians are located nearby so you can dispatch the appropriate technician for the customer's location.

    For general information about how geolocation is used on the ServiceNow platform, see Geolocation.

    Share location details

    The first time a user, such as a field technician, uses the Geolocation topic block in a conversation, they are asked if they would like to share details about their location.

    The chatbot asks, "Would you like to share your location?" Choices are No and Yes.

    Table 1. Geolocation topic block flow
    User choice Topic block response
    Yes The topic block sends the user's latitude and longitude coordinates from the server to the user's device.
    If users want to allow the ServiceNow instance to access their location, users may then see operating system-specific or browser-specific prompts. Examples of such prompts include the following:
    • Allow (always)
    • Allow (one time only)
    • Block (don't allow)

    Depending on the user's response, they may see this prompt one or more times, or they may never see it.
    No The topic block does not retrieve user coordinates and displays a relevant error message for the topic author to resolve. The error is logged as an output parameter. For details, see Geolocation topic block parameters.

    Modify the Geolocation topic block

    If you are a topic author or an admin, you can modify the Geolocation topic block flow, as applicable. Simply duplicate the topic block and rename it. You can then use it as needed in the larger conversation flow you're designing.

    The Geolocation topic block properties sheet lets topic authors specify the input and output mappings. You can also customize the prompt using data pills or scripts. For example, you can include an explanation or reason for asking the question. For information about using data pills and scripts, see Virtual Agent Designer controls.
    Figure 1. Share location prompt in the Geolocation topic block properties
    The value of the permissionPrompt string is "Would you like to share your location?"

    Use the input mappings to customize how Virtual Agent asks users for permission to share their location. The response is passed to the topic block.

    Use the output mappings to specify the variables that are returned from the topic block in the conversation.
    Figure 2. Output mapping properties in the Geolocation topic block
    Geolocation output mapping parameters include latitude, longitude, errormessage, errortype, and status.

    All the variables are selected by default. Keep the default choices, or select the variables you want returned from the topic block. At a minimum, you should select the latitude and longitude coordinates. However, error messages, error type, and status details could be useful when resolving problems. The output mappings you select are stored as variables on the server.

    Figure 3. Geolocation topic block results
    Geolocation topic block results read, "This is what I got back," followed by the latitude and longitude, an OK status, and no error.

    For more information about the Geolocation topic block properties, see Geolocation topic block parameters.