Skip to main content


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

Nearby locations

Updated on April 9, 2021

The Nearby locations process enables you to view important nearby places such as hospitals, schools, and so on that are supported by Google's Near Me service. You can also view the nearby cases and entities that are already in the application.

Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide

For example, if there is an application for school license, any reviewer can use this component to see if there are any bars or liquor stores in the nearby area and take the approval decision based on that. Also, for any investigation case for multiple events reported, the field investigators can use this component to check the event case in the nearby area.

Configuring Nearby locations

Use the Nearby locations process component in a case type as a step in any of the stages. You can configure the base location for searching nearby cases, entities, or places either with the current location, or using a property reference.

  1. Log in to Pega Government Platform as an administrator.
  2. In the header of your workspace, click the Switch Studio menu, and then click App Studio.
  3. In the navigation pane of App Studio, click Case types.
  4. From the Case types column, click a case type, or click the New button to create a new case type.
  5. In the Case life cycle section, click Stage, and then enter a name in the text box.
  6. Hover over process, and then click +STEPMoreProcessesNearby locations.
  7. Click the Select button.
  8. In the Location details section, in the Source list, select Current location to configure the current location as the base location for searching nearby cases, entities, or places.
  9. Alternatively, select By property reference, and then enter or select a property from the combo box.
  10. Select the Enable nearby result selection check box to select the nearby search results for further processing in the next steps or stages.
  11. In the Routing details area, select an operator:
    • To route the assignment to the current operator, click Current operator.
    • To specify a user or operator to whom you want to route this assignment, click Specific user, and then, in the User field, select a user or enter a property in the work class that supplies a specific operator ID at run time.
    • To route the assignment to a specific work queue, click Work queue, and then, in the Queue field, select a work queue name or enter a property in the work class that supplies a specific work queue at run time.
  12. Click Save.
  13. To show a list of selected nearby places, click the Views tab, and then click Create new view.
    1. In the Search box, enter Selected nearby places, and then click the Add to view icon.
  14. To show a list of selected nearby cases or entities, Views tab, and then click Create new view.
    1. In the Search box, enter Selected nearby cases and entities, and then click the Add to view icon.
  15. Click Submit.

Extending Nearby locations

Extend the Nearby locations component depending on the business use case and requirement.

Enabling a new case type for Nearby cases search

Enable a new case type to retrieve on search.

  1. Log in to Pega Government Platform as an administrator.
  2. In the header of your workspace, click the Switch Studio menu, and then click App Studio.
  3. In the navigation pane of App Studio, click Case types.
  4. From the Case types column, click a case type, or click the New button to create a new case type.
  5. In the Case life cycle section, click Stage, and then enter a name in the text box.
  6. Hover over process, and then click +STEPMoreProcessesPersist proximity location.
  7. Click the Select button.
  8. Expand Parameters and pass the property, which has the location to the process, as a parameter.

Extending a new entity for nearby entity search

Add a new entity apart from the PGP-provided entities, as a part of nearby entity search, in the Nearby locations component.

For example, the AddressList property contains the addresses of a person. While saving the person details, the PersistEmbeddedPage activity (CL:PegaPS-Data-Entity-Person) runs which has the logic to save AddressList in PegaPS-Data-Address table.

    Show new entity as one of the type in nearby cases and entities

  1. In the navigation panel of Dev Studio, click Data types.
  2. Click Data typesOption map.
  3. Click the Records tab.
  4. Click Add record to add a new entity with Field Name / Group as Entity.

  5. Save as NearbyCasesList_Ext data transform and set pyClassName to new entity class when pyLabel is new entity.
  6. Save as FetchProximityEntity report definition (CL:PegaPS-Data-Entity-Facility) into New entity class and remove the Name property from columns.
  7. Create a new data page similar to D_FetchFacilityProximity and call the report definition created in the previous step.
  8. To show a different marker pin, on the map, for the new entity, save as SetEntityMarker data transform into the new entity class and set the MarkerImage property with any binary file.
  9. Save as SetNearbyAddressList_Ext activity, and load the data page created in step 7.
  10. Save as SetNearbyCasesEntitesResult_Ext data transform and append data page results to NearbyCasesEntities property.

Tags

Pega Government Platform 8.7

Have a question? Get answers now.

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

Visit the Support Center

Did you find this content helpful?

Yes
No

Want to help us improve this content?
Suggest an edit

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us