devguard
Collections

Locations

Record your offices, data centers and other sites once, with an address and map coordinates, and link assets and vendors to them.

A location is a place where your organization works or keeps data, such as the head office or a data center. You save it with an address and coordinates. Assets and vendors point to a location, so you can see what is at each site. Policies and records can mention it with :, and the policy PDF prints the address.

To import, archive or delete locations, see Collections. Scripts and integrations: see API below.

Add a location

  1. Open Collections, then Locations, and choose Add location.
  2. Enter the Name, for example Zurich head office, and a Description if you want.
  3. Choose Select location. A dialog opens.
  4. Type the address in the search field and choose the right result. The map shows the place and the coordinates are filled in.
  5. If the pin is not exactly right, open Fine-tune Coordinates and change Latitude or Longitude.
  6. Choose Save Location, then Create.
The Select Location dialog: the selected address Bahnhofstrasse 1, Zürich, the latitude and longitude fields, and a map with a pin.
The search fills in the address and the coordinates. The map shows where the pin is.

See what is at a location

  1. Open the location.
  2. On the Detail tab, Related Data lists the assets and vendors that use it.

To link an asset or a vendor, open it, choose Edit and choose the location.


Reference

FieldRequiredNotes
Nameyes2 to 255 characters.
Descriptionno
Locationyes in the appThe address, chosen in the search. The policy PDF prints it in place of a mention.
Latitude, LongitudenoFilled in by the search. Change them under Fine-tune Coordinates.
SlugyesMade from the name. See Collections.
  • The address search and the map use Google Maps.
  • A CSV import does not search for the address. Fill in latitude and longitude yourself if you need them.
  • In an asset or vendor CSV import, the locationId column can hold the location's name instead of its id.
  • When you delete a location, the assets and vendors that used it keep no location.

CSV columns

The template from Download CSV template has these columns. Leave slug empty to make it from the name.

locations.csv
slug,name,description,latitude,longitude,address
zurich-head-office,Zurich head office,,47.3673,8.5399,"Bahnhofstrasse 1, 8001 Zürich"

API

The calls are the same for all collections; see the Collections API. The path is /locations/.

FieldTypeRequired
organizationIdstringon create
namestring, 2 to 255 charactersyes
slugstring, lowercase with hyphensyes
description, addressstringno
latitude, longitudenumberno
POST /locations/
{
  "organizationId": "<organization id>",
  "name": "Zurich head office",
  "slug": "zurich-head-office",
  "address": "Bahnhofstrasse 1, 8001 Zürich, Switzerland",
  "latitude": 47.3673,
  "longitude": 8.5399
}

How is this guide?

On this page