Add Support for Google Map Data

By default, the main OmniScript for Self-Service Appointment Management accepts only ZIP codes for location data. You can add support for Google Map data.

Available in: Lightning Experience

Available in: Enterprise and Unlimited Editions with Health Cloud


User Permissions Needed
To use OmniStudio OmniStudio Admin permission set
To add support for Google Map data, you must obtain a Google Maps API Key from Google.
  1. Create a new version of the healthCloudIAM/selfService OmniScript.
    1. In the source org, from the App Launcher, open the OmniStudio app.
    2. Go to the OmniScripts page and enter healthCloudIAM in the search field.
    3. Expand the healthCloudIAM/selfService OmniScript.
    4. Click the link for the highest version.
      The OmniScript opens in the OmniScript Designer.
    5. Click New Version.
      The Version value in the Header is incremented.
  2. In the Navigation Panel, click the Tree View icon.
    The Tree View lets you view and select step subcomponents.
  3. Edit the SelectLocation step.
    1. Select the SelectLocation step.
    2. In the Navigation Panel, expand the SelectLocation step.
    3. Click PatientZipCode.
    4. In the Number Properties panel, deselect Active.
    5. In the Navigation Panel, click Location.
    6. In the Type Ahead Block Properties panel, select Active.
    7. In the Type Ahead Block Properties panel, scroll to the Google Maps Autocomplete section.
    8. Enter your Google Maps API Key.
    9. In the Navigation Panel, click CheckCompleteAddress.
    10. In the Formula Properties panel, select Active.
    11. In the Navigation Panel, click CompletAddressMsg.
    12. In the Messaging Properties panel, select Active.
  4. Edit the ScheduleProvider step.
    1. Select the ScheduleProvider step.
    2. In the Navigation Panel, expand the ScheduleProvider step.
    3. Click FilterPatientZipCode.
    4. In the Number Properties panel, deselect Active.
    5. In the Navigation Panel, expand MoreFilters.
    6. Click SearchPatientLocation.
    7. In the Type Ahead Block Properties panel, select Active.
    8. In the Type Ahead Block Properties panel, scroll to the Google Maps Autocomplete section.
    9. Enter your Google Maps API Key.
    10. In the Navigation Panel, click CheckFilterAddress.
    11. In the Formula Properties panel, select Active.
    12. In the Navigation Panel, click ValidAddress.
    13. In the Messaging Properties panel, select Active.
  5. Edit the Apply Filter button in the ScheduleProvider step.
    1. In the Navigation Panel, click IntegrationProcedureAction1.
      As an alternative, you can click the Apply Filter button in the step.
    2. In the Integration Procedure Action Properties panel, next to the Integration Procedure field, click the icon to open the Integration Procedure.
      The healthCloudIAM-FetchProviderAndTimeSlotsFilter Integration Procedure opens in the Integration Procedure Designer.
    3. Select the DRTransformProviderSearchInput step.
    4. In the DataRaptor Transform ActionProperties panel, next to the DataRaptor Interface field, click the icon to open the DataRaptor.
      The HealthCloudIAMTransformProviderSearchFiltersInput DataRaptor opens in the DataRaptor Designer.
    5. Click New Version.
    6. Go to the Transforms tab if you aren't already there.
    7. Edit the ScheduleProvider:FilterPatientZipCode Input JSON Path and check Is Disabled.
    8. Edit the ScheduleProvider:MoreFilters:SearchPatientLocation-Block:FilterPatientZipCode Input JSON Path and deselect Is Disabled.
    9. Click Activate.
  6. In the OmniScript Designer, edit the IPGetProviderAndSlots step.
    1. Select the IPGetProviderAndSlots step.
    2. In the Integration Procedure Action Properties panel, next to the Integration Procedure field, click the icon to open the Integration Procedure.
      The healthCloudIAM-FetchProviderAndTimeSlots Integration Procedure opens in the Integration Procedure Designer.
    3. Select the DRTransformProviderSearchInput step.
    4. In the DataRaptor Transform ActionProperties panel, next to the DataRaptor Interface field, click the icon to open the DataRaptor.
      The HealthCloudIAMTransformProviderSearchInput DataRaptor opens in the DataRaptor Designer.
    5. Click New Version.
    6. Go to the Formulas tab.
    7. Next to the UpdatePatientZipCode Formula Result Path, check Is Disabled.
    8. Go to the Transforms tab.
    9. In the Input JSON Path column, rename the UpdatedPatientZipCode field to InputPatientZipCode.
    10. Click Activate.
  7. In the OmniScript Designer, click Activate Version.