The terminology used in the ALK Content Tools are ‘Places’ and ‘Place Set’. A ‘Place Set’ is a list of ‘places’.
           
A ‘Place’ or a ‘POI’ has the following attributes:

  • Latitude
  • Longitude

  • Name

  • Name of the ‘Place Set’ it is associated with

  • Street Address

  • City

  • State

  • Zip/Postal Code

  • Phone Number

  • Comments


A ‘Place’ must exist within a ‘Place Set’.

A ‘Place Set’ can be created in two ways; 1. Using the ‘Import’ option; 2. Using the ‘New Set’ button. 

Activate the ‘Place Sets’ panel by clicking on the ‘Places’ option from the top menu ribbon:




Figure 1



  1. Option 1 - Import Places: Import a ‘Place Set’ via .CSV file by clicking on ‘Import...’. The .CSV file must contain a list of ‘Places’ where the attributes are separated with a delimiter (Comma, Tab, or Pipe). The columns are typically specified in the following order: Name, Latitude, Longitude, Street, City, State, Zip, Phone, Comments. The required attributes or fields for the upload to pass are a combination of name, latitude and longitude; city and state; zip code.

    Note: The .CSV file must contain at least one row of data.


    Figure 2


    • To import a ‘Place Set’ click on ‘Import…’:

      Figure 3

      Things to Note:
      1. The list of acceptable file types are: CSV File, Text Document, XLSX File, DOCX File, and Rich Text Format.

      2. The import file must include the following fields: latitude and longitude, city and state, or zip code. The fields - Place Name, Phone, and Comments are optional.

      3. The following are the formats required for the field values:

          3.1. Place Name: can contain alphanumeric and special characters except comma, tab, and pipe;

              maximum of 140 characters are allowed.
          3.2. Latitude: must be a number from -90 to +90 (South latitudes are represented by minus sign).
          3.3. Longitude: must be a number from -180 to +180 (West longitudes are represented by minus sign).

          3.4. Street Address: can contain alphanumeric and special characters except comma, tab, and pipe;

              maximum of 100 characters are allowed.

          3.5. City: can contain alphanumeric and special characters except comma, tab, and pipe;  maximum of

              100 characters are allowed.

          3.6. State: must be a two-letter abbreviation.

          3.7. Zip Code: can contain alphanumeric and special characters except comma, tab, and pipe;

               maximum of 25 characters are allowed.

          3.8. Phone: can contain alphanumeric and special characters except comma, tab, and pipe; maximum

               of 15 characters are allowed.

          3.9. Comments: can contain alphanumeric and special characters except comma, tab, and pipe;

              maximum of 140 characters are allowed.


    • You have 3 options to import a ‘Place Set’. 1. New Set; 2. Append to Set; 3. Replace Set

    • New Set: Select ‘New Set’; Enter the name of the new set in the ‘New Set Name’ box; Click on the ‘Choose File…’ to upload a CSV file from the file system; Click ‘Continue’. Or, drag and drop your file in the ‘drop file here’  area.

      Note: CSV file name will be set as the ‘New Set Name’ upon selection, however, it can be changed.


      Figure 4

    • Replace Set: Replaces an existing set. Click on Replace Set Radio; select an existing set from the dropdown; click on ‘Choose File…’ to upload a .CSV file; click on ‘Continue’.

      Figure 5


      Figure 6

    • Upon clicking the ‘Continue’ button (applicable for New Set, Append to Set, and Replace Set) the content of the .CSV file is displayed:

      Figure 7


    • Click on ‘Continue’ to view the import match results; Click on ‘Finish’.

      Figure 8


  2. Option 2 - Clicking on ‘New Set’ button to create a new ‘Place Set’: Click on ‘New Set’ button -> Type the name of the ‘New Set’ and click on ‘Save’ button to save the set.

    Note: Creation of duplicate sets is not allowed.

    Figure 9

  3. The ‘Place Set’ panel contains the list of ‘Place Sets’ created on your account.

    Figure 10
    • Click on to navigate to the list custom places.

    • Click onto view the places on the map.

    • Click on  to delete a set, edit the set name, and frame the set (i.e.the places are displayed in zoomed-in map area, the frame set option is enabled only when the toggle button is switched on).

    • CoPilot Settings: When a new set is created, 3 different types of settings that are offered:

                      1. Display on Map: When checked, displays all the POIs within the set on the map in CoPilot
                      2. Searchable: When checked, all the POIs can be searched in CoPilot
                      3. Alertable: When checked, an alert notification is shown in CoPilot upon approaching the POI.

                      Note: By default all 3 setting options are checked.

                     

    • The user can search for a ‘Place Set’ or ‘Places’ using the filter option.

      To search for a set, start typing the name.


    • Click on ‘Frame All’    to view the selected ‘Place Set(s)’ on the zoomed-in map area.

    • Click on  to cluster places close to each other.

    • To export the list of ‘Places’ click on ‘Export’ found at the lower right corner in the ‘Places’ panel.


    • To see the custom places within a particular set click on . Here’s what the panel UI looks like:

      Figure 11

  4. To add a Custom Place, follow these steps:
    • Select a ‘Place Set’.

    • Click on the map to add a new Place or find a Place by using ‘Search’.The window to add a new ‘Place’ pops up when you click on the map area at any zoom level.

      Figure 12

    • Or, click on ‘Search’ within the ‘Place Set’ panel:

      Figure 13


      Figure 14

    • Next, click on ‘Add Place’ to add the POI.

      Note: The user can also search for a location using ‘Search’ option from the top menu ribbon bar. Search using Street Address or via Lat, Long. The user cannot add a place using this option. It is used only for searching and viewing the location on the map.


      Figure 15



    • Update the Place name and any other changes. Click on Save.

      Note: Save the Place before moving to Site definition.