Add location (Command ID) / Add location by executing a task

This functionality is available under 'Task Settings', available in the 'Advanced Settings' section.

This function aims to create a new location within the group of locations in which the task was performed (i.e. adding a location to the group of locations associated with a sentence) by answering open commands (this type of command only). Business example: A salesman moves around an area, sees a potential contractor, wants to add their location to their task base, runs a specially prepared task (or part of another task) and completes information such as: street, house number, zip code, city. After completing the task, the system combines the entered data into one string and asks the Google Maps API for the coordination of this address (during which validating if the address exists), if the response from Google isreturned the address will be created.

Please Note: The user has no information about success or failure (error/non-existent address) of adding the address to the app database, this validation takes place in the background, on the server side of the backend application in cycles of every 15 minutes (answers are collected in the last 15 minutes window and a query is sent to Google Maps API).

Configuration

Using the function is to add in the 'Advanced Task Settings' section the parameters (Command ID) from which the address is to be created. The command ID is entered in the 'Add Location' (Command ID) field. The field does not validate the correctness of the entered numbers, it tries to retrieve the answers given from these open commands and then combines them into one sequence. There is no limit to the number of commands which can be connected, depending on business needs (way of collecting the address) it can collect separate information such as: street, house number, apartment number or all this information collected in one field.
Please Note: Google Maps API service does not work the same way as Google Maps service, if the address will be too imprecise e.g. street itself with a number without a city, without a zip code or sometimes without a country - Google Maps API may not return the coordinates of such an address even though Google Maps service in the browser returns the address).

There is an additional parameter: "Write to the location after the sentence has been completed" - when active, it will cause the user who completed the task to be automatically added to this location in the 'Users' section of the location (in the opposite case, the location will be created, but the user will not be added to it).

Which parameters will the added location receive:

Location address with coordinates. The user's response is parsed and sent to the Google Maps API, then Google returns the standard address (modifies the address according to its naming).
Location name - The same name as in the location address returned by Google (may not be identical to the one entered by the user).
Location ID (External ID) - It is completed automatically as a sequential number starting from 10,000.
Location Radius - This can be set as a single global parameter for an instance. (CreateLocationEntitiesFromCommandAnswersLocationRadius). Default: 10,000 meters.

Functionality requires configuration in the main position application settings: EnableCreateLocationEntitiesFromCommandAnswersLocationRadius (activation of the job parsing address and the Google API asking for address coordinates, sequence of work: every 15 minutes) and CreateLocationEntitiesFromCommandAnswersLocationRadius (configuration of the base size of the radio).

Please Note: Every 1,000 Google Maps API queries are payable (about 5 USD/1,000), the precise (current) price list is there.