Custom Place files can be imported into ALK Content Tools as a .CSV File, Text Document, .XLSX File, .DOCX File, or in Rich Text Format. Files must contain a list of Places with descriptive fields separated by a delimiter (Comma, Tab, or Pipe "|"). 


The import file must include a Place Name and either address information or latitude and longitude coordinates. All other fields are optional. If you do not include a field, empty pipes must be included in your text file as placeholders. 


The fields should be listed in the following order: 


1. Place Name (Required)

  • Max character count = 140

  • The name need not be unique

  • Can contain alphanumeric and special characters except comma, tab, and pipe


2. Place ID (Optional)

  • Max character count = 24

  • The name need not be unique

  • Can contain ONLY Alphanumeric characters


Address Information(Optional if Latitude/Longitude is provided)


3. Street Address (Optional)

  • Can contain alphanumeric and special characters except comma, tab, and pipe

  • Max character count = 100


4. City (Required)

  • Can contain alphanumeric and special characters except comma, tab, and pipe

  • Max character count = 100


5. State (Required)

  • Must be a two-letter abbreviation.


6. Zip Code (Required)

  • can contain alphanumeric and special characters except comma, tab, and pipe

  • Max character count = 25


7. Latitude (Optional if Address Information is provided)

  • Latitude (in decimal degrees format): must be a number from -90 to +90. (South latitudes are represented by minus sign).


8. Longitude (Optional if Address Information is provided)

  • Longitude (in decimal degrees format): must be a number from -180 to +180. (West longitudes are represented by minus sign).

NOTE: 

  • If both address and lat/long are in the import file, then the location will be plotted using the lat/long.

  • If only address is present in the import file, then the address will be used to geocode and find the coordinates for the Place. The Place is then plotted using the coordinates.

  • If only coordinates are present in the import file, then the place is plotted using the lat/long. No reverse geocoding will be performed to identify the address of the place.


9. Phone (Optional)

  • Can contain alphanumeric and special characters except comma, tab, and pipe

  • Max character count = 15


10. Comments (Optional)

  • Can contain alphanumeric and special characters except comma, tab, and pipe

  • Max character count = 140


11. SiteName (Optional)

  • Max character count = 100

  • Name need not be unique

  • Can contain alphanumeric and special characters except slash (/), backslash (\), or caret (^) characters


12. ShapePoints (Optional)

  • Shape points are lat/lons (see format above) delimited by the pipe character (|). Each point is a lat/lon separated by one comma (,)

  • At least three shape points are required


13. SiteGates (Optional)


Gates are first delimited by the caret character (^). For each gate, the fields are separated by pipes again (|). The fields are, in order:

  • Coords (actual physical location; location within the Site) - Required
  • SnapCoords (location on the road; gate entrance connecting road to Site) - Required
  • Type (0 for Entry, 1 for Exit, 2 for Entry/Exit) - Required
  • AutoRestricted (1 for true; anything else for false [typically 0]) - Required
  • TruckRestricted (1 for true; anything else for false [typically 0]) - Required
  • Gate Note (string, with `^`, `|`, and `\` characters each escaped with preceding backslash `\` character) - Optional


SiteGates are optional but, if passed, all above required fields except for the Gate Note must be populated.


TIP: A sample .CSV file is attached.