Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Displaying location as static map image

Updated on April 5, 2022

Harness and Section forms - displaying location as a static map image

Before you begin: The Static Maps API uses an API key to identify your application. API keys are managed through the Google APIs Console. For more information, see Creating Static Maps API key.

Using the Google Static Maps API facilitates showing an address or longitude/latitude coordinates as a static map image containing a pin with the location. This allows users to display a geographical location visually in an application, for instance, when offline. To accomplish this, invoke the pyFetchStaticMap activity with a set of parameters.

The pyFetchStaticMap activity populates any property with a Base64 image data representing the map and uses that property as an image source with the Icon /Image control. The use cases for pyFetchStaticMap are unlimited since it can be called from any other activity. Some of its most common use cases are outlined below - when you want to:

  • Show a static image map immediately:
    • call this activity from a post-load processing activity of a data page
    • call this activity from a preprocessing activity of a flow action
  • Save a static map image data to a database:
    • use the activity from a postprocessing activity of a flow action

The following steps describe a user case calling the pyFetchStaticMap activity from a post-load processing activity of a data page. Step 1 is always performed no matter the context.

  1. Define an image (the Icon/Image control), for instance, in a section. It will represent the target property where the static Google map with the address location will be saved and displayed.

  2. Create a post-load processing activity for a data page.

  3. In the Steps tab invoke the pyFetchStaticMap activity by entering Call pyFetchStaticMap in the Method field.

  4. Make sure to define a step page context.

  5. Expand and enter values for the method's parameters:

    targetPropertyRequired. Defines target property where the static Google map image with location is to be saved. The entered value must be in double quotes. The format should be Text. The map image data is saved in Base64 format in this property.
    markerAddressRequired. A property which references a longitude/latitude coordinates or a human-readable geographical address of the location to be displayed in the static map, for instance, "40.689249, -74.044516" or "Statue of Liberty, Liberty Island, Brooklyn, NY 11231, USA".
    widthRequired. The width of the image in pixels, for instance, 300.
    heightRequired. The height of the image in pixels., for instance, 100.
    zoomLevelSpecifies the zoom level on the map. Only values between 0 and 21 (inclusive) are permitted. The default value is 15.
    mapType Defines the type of Google map to display:
    • roadmap (default)
    • satellite
    • hybrid
    • terrain
    imageType Defines the type of image to use:
    • GIF
    • JPEG
    • PNG (default)

  • Displaying location as static map image

    Harness and Section forms - displaying location as a static map image

  • Keystores

    A keystore is a file that contains keys and certificates that you use for encryption, authentication, and serving content over HTTPS. In Pega Platform, you create a keystore data instance that points to a keystore file.

  • harnesses

    Organize the content and structure of a portal by defining harnesses. By populating harnesses with sections, you can build a modular interface that promotes reuse and maintainability.

  • Sections

    Sections are the building blocks of your user interface. You can populate a section with components, such as fields and controls, to create a functional chunk of user interface that can be reused in different contexts for improved consistency and efficient development.

  • Previous topic Configuring a text label in a layout cell or header
  • Next topic Adding paragraphs to place rich text in a layout cell or header

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us