Setting Up a Google Places Service in Service Administration
The first step in using Google Places address look-up is adding the Google Place Details API service. You'll do this in Services Administration. You must have a Google Places API key to set up a Google Place Details Service.
To learn more about getting a Google Places API key, visit the following link: https://developers.google.com/places/web-service/get-api-key.
|
1.
|
At the top right of the Unqork Designer Platform, click . |
|
2.
|
Under Integration, click Services Administration. |
|
3.
|
At the top right of the page, click + Add a Service. The Create New Service displays. |
|
4.
|
In the Service Title field, enter {teamName} - Google Places. Replace {teamName} with your initials or the name of your application team. For example, Sales - Google Places. |
|
5.
|
In the Service Name field, enter {teamName}-google-places. |
Use lowercase alphanumeric characters along with a hyphen (-). A Service Name cannot not start or end with a hyphen. There cannot be consecutive hyphens in a Service Name.
|
6.
|
Click Next. The Manage Access page displays. |
|
7.
|
From the Share To setting, choose to share with the environment or a specific workspace. |
|
8.
|
Click Create. The service's information page displays. |
|
10.
|
From the menu to the left, click Service Type |
|
11.
|
From the Authentication method drop-down, select Google Places. |
|
12.
|
In the API Key field, enter the Google Places API key. |
|
13.
|
Click Save Changes. The Services Administration page loads, displaying the new service in the list. |
Configuring an Address Search Component to Use the Google Place Details Service
Configure an Address Search component to use the Google Place Details service. These instructions assume that you have an open module saved with a title.
|
1.
|
In the Module Builder, drag and drop an Address Search component onto your canvas. |
|
2.
|
In the field, enter address. |
|
3.
|
In the field, enter Enter Your Address:. |
|
4.
|
Select any of the Show Street, Show Street 2, Show City, Show State, Show Zip, and Show Country options as desired. Selected fields display in and populate with the data returned by the Google Places API. |
All location data returned by the Google Places API stores in the submission data, even if you do not select the respective option.
|
5.
|
Navigate to the Data settings. |
|
6.
|
From the Select API drop-down, select the Address Service created in the previous section. In this case, sales-googleplaces. Doing so connects your Address Search component to the Google Places service you added in Services Administration. |
If only one Address Service exists, it's selected by default.
You're now ready to use Google Places-enabled address search.
Setting Up a Canada Post Service in Service Administration
To use the Canada Post address look-up, you must configure the Canada Post service. You'll do this in Services Administration. You must have a Canada Post API key to set up a Canada Post Service.
To learn more about getting a Canada Post API key, visit the following link: https://www.canadapost-postescanada.ca/ac/support/setup-guides/#create-an-api-key.
|
1.
|
At the top right of the Unqork Designer Platform, click . |
|
2.
|
Under Integration, select Services Administration. |
|
3.
|
At the top right of the page, click + Add a Service. |
|
4.
|
In the Service Title field, enter {teamName} - Canada Post. Replace {teamName} with your initials or the name of your application team. For example, Sales - Canada Post. |
|
5.
|
In the Service Name field, enter {teamName}-canada-post. |
Use lowercase alphanumeric characters along with a hyphen (-). A Service Name cannot start or end with a hyphen. There cannot be consecutive hyphens in a Service Name.
|
6.
|
Click Next. The Manage Access page displays. |
|
7.
|
From the Share To setting, choose to share with the environment or a specific workspace. |
|
8.
|
Click Create. The service's information page displays. |
|
10.
|
From the menu to the left, click Service Type |
|
11.
|
From the Authentication method drop-down, select Canada Post. |
|
12.
|
In the API Key field, enter the Canada Post API key. |
|
13.
|
Click Save Changes. The Services Administration page loads, displaying the new service in the list. |
Configuring an Address Search Component to Use the Canada Post Service
Configure an Address Search component to use the Canada Post service. These instructions assume that you have an open module saved with a title.
|
1.
|
In the Module Builder, drag and drop an Address Search component onto your canvas. |
|
2.
|
In the field, enter address. |
|
3.
|
In the field, enter Enter Your Address:. |
|
4.
|
Select any of the Show Street, Show Street 2, Show City, Show State, Show Zip, and Show Country options as desired. Selected fields display in Express View and populate with the data returned by the Canada Post API. |
All location data returned by the Canada Post API stores in the submission data, even if you do not select the respective option.
|
5.
|
Navigate to the Data settings. |
|
6.
|
From the Select API drop-down, select the Address Service created in the previous section. In this case, sales-canadapost. Doing so connects your Address Search component to the Canada Post service you added in Services Administration. |
If only one Address Service exists, it's selected by default.
You're now ready to use Canada Post-enabled address search.