Skip Navigation

Select an alert or event location

There are two ways to add locations to an alert or event on the publisher map:
  • Define custom locations using the drawing tools available on the map.
  • Select geographic areas from a list of locations that were predefined by a
    BlackBerry AtHoc
    administrator.
Users with any geolocation attribute in the selected location are targeted in the alert or event. In addition, any users with a Last Known Location attribute that was updated within the configured timeframe are also targeted.
  1. In the
    Content
    section of an alert template, or in the
    Event Details
    section of an event template, click
    Add
    in the
    Location
    section. The publisher map opens.
    Add a location from an alert
    If you have the necessary permissions, you can set the default map area in the Map Settings screen. For more information, see Configuration and Setup.
  2. Optionally, if the location you want to target is not displayed on the current map, enter the address, point of interest, or longitude/latitude value pair in the
    Find a place
    field. Press
    Enter
    on your keyboard to refresh the map location.
    The Find a place search field
  3. To use a predefined location on the map as a targeting criterion, click
    Select Predefined Locations
    to access a drop-down menu where you can select any predefined layers. When you select a layer, the map updates automatically to display the layer location on the map.
    Shape layers must be made selectable in the Map Settings. For more information, see Shape layers.
    Uploading multiple layers with different sets of predefined locations is recommended to improve usability and system performance. Shape layers are configured on the Map Settings screen. Administrators can access them at
    Settings
    >
    Basic
    >
    Map Settings
    . For more information, see Shape layers.
  4. Select one or more predefined locations within the layer by clicking them on the map or selecting them in the drop-down menu. As you make selections, the locations are highlighted on the map.
    Select a predefined location on the map
  5. To create a custom location, click
    Create Custom Locations
    to display the drawing tools for creating shapes.
    Create custom locations
  6. In the
    Create Custom Locations
    toolbar, select a shape and click and drag on the screen to select the location you want to use in the alert or event.
    Draw a custom location on the map
  7. To view the size of a custom location, click the shape on the map. A black box appears beside the Create Custom Locations button, listing the total area of the custom location in square miles or square kilometers.
    Change the shape of a custom location
  8. To edit a custom location, click the shape and then click and drag on any of the circles that appear around the edge of the shape.
  9. To scale new shapes up and down while preserving their dimensions, complete the following steps:
    1. Press and hold the SHIFT key on your keyboard.
    2. Click and release the shape to select it.
    3. Move your cursor over one of the white squares around the shape.
    4. Click and hold on the white box while dragging the mouse to increase or decrease the shape size.
      As you create shapes and select predefined locations on the map, the
      Location Summary
      field in the bottom-right corner updates to provide you with an overview of the total number of locations that are displayed on the map and the locations that will be included in the alert or event.
      The location summary
  10. To delete the custom locations you created, in the
    Location Summary
    section, click the
    X
    beside the custom locations. If you have created more than one custom location, they are combined in the list and cannot be deleted individually. To delete a single custom location, click the border of the location shape on the map to select it, then click The delete icon on the Create Custom Locations toolbar.
  11. To view the total number of users and organizations that are located within the selected map locations, click
    Calculate
    beside the
    Select By Location
    field.
    Calculate the users and organizations in the selected locations
    Users and organizations listed in the Select By Location field are automatically added to the alert or event target list. To remove them as targets, deselect
    Target Users
    and
    Target Organizations
    . For more information, see Target users by location.
  12. Optionally, in the
    Select by Location
    section, click
    Export
    to export the targeted users or organizations.
    Export targeted users
    1. On the
      Export Options
      window, select the columns to export in the left column and click
      Add
      .
    2. Optionally, use the control buttons on the right to order the selected columns.
    3. Click
      Export PDF
      or
      Export CSV
      .
      You can export up to 1000 users to a PDF file. You can export up to 25,000 users to a CSV file in a single export. If you are exporting more than 25,000 users to a CSV file, select a grouping of 25,000 users to export.
      The PDF or CSV file downloads to your system.
    4. Click
      Cancel
      to close the
      Export Options
      window.
  13. Click
    Apply
    .
To target users with geofence targeting, see Enable geofence targeting.
For more information about the publisher map, see Manage the publisher map.