Skip to main content

Apple Location Visits Export Format

  • Updated

Apple Location Visits are the record of locations that participants in your project have visited. This only applies if you have location tracking enabled for your project, your participants are using an iOS device, and the participants have enabled location sharing with MyDataHelps.

Data is collected using the visits location service. There is one entry for each visit.

Table of Contents

Data Fields

Field Description
AppleLocationVisitKey A unique, auto-generated key for the visit.
ParticipantIdentifier The identifier of the participant this task was for. Can be used to cross reference with Participants.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
ArrivalTime The timestamp for when the participant arrived at a location, in ISO 8601 format. May be empty (for instance if the device was turned off during arrival to a location).
DepartureTime The timestamp for when the participant departed from a location, in ISO 8601 format. May be empty (for instance if the device was turned off during departure from a location).
Latitude The latitude of the location.
Longitude The longitude of the location.
HorizontalAccuracy The accuracy of the reading, in meters. Click here for more information.
InsertedDate The creation date of the visit entry, in ISO 8601 format. Is always in UTC.

Sample CSV Export

AppleLocationVisitKey,ParticipantIdentifier,ArrivalTime,DepartureTime,Latitude,Longitude,HorizontalAccuracy,InsertedDate
36cfcfc7-91e6-e811-bf5f-ecf4bb644518,58d7d0c1-91e6-e811-bf5f-ecf4bb644518,2018-11-03T00:00:00-04:00,2018-11-03T04:45:00-04:00,42.244965253548031,-83.792536237749047,57.3684247864263,2018-11-12T15:44:05Z
37cfcfc7-91e6-e811-bf5f-ecf4bb644518,58d7d0c1-91e6-e811-bf5f-ecf4bb644518,2018-11-03T04:45:00-04:00,2018-11-03T05:54:00-04:00,42.228402119039565,-83.781444712496565,18.1900001127226,2018-11-12T15:44:05Z
38cfcfc7-91e6-e811-bf5f-ecf4bb644518,58d7d0c1-91e6-e811-bf5f-ecf4bb644518,2018-11-03T05:54:00-04:00,2018-11-03T07:04:00-04:00,42.165086005554862,-83.719882045658707,33.3561806070414,2018-11-12T15:44:05Z

Sample JSON Export

{
  "AppleLocationVisitKey": "36CFCFC7-91E6-E811-BF5F-ECF4BB644518",
  "ParticipantIdentifier": "58d7d0c1-91e6-e811-bf5f-ecf4bb644518",
  "ArrivalTime": "2018-11-03T00:00:00-04:00",
  "DepartureTime": "2018-11-03T04:45:00-04:00",
  "Latitude": "42.244965253548031",
  "Longitude": "-83.792536237749047",
  "HorizontalAccuracy": "57.3684247864263"
}
{
  "AppleLocationVisitKey": "37CFCFC7-91E6-E811-BF5F-ECF4BB644518",
  "ParticipantIdentifier": "58d7d0c1-91e6-e811-bf5f-ecf4bb644518",
  "ArrivalTime": "2018-11-03T04:45:00-04:00",
  "DepartureTime": "2018-11-03T05:54:00-04:00",
  "Latitude": "42.228402119039565",
  "Longitude": "-83.781444712496565",
  "HorizontalAccuracy": "18.1900001127226"
}
{
  "AppleLocationVisitKey": "38CFCFC7-91E6-E811-BF5F-ECF4BB644518",
  "ParticipantIdentifier": "58d7d0c1-91e6-e811-bf5f-ecf4bb644518",
  "ArrivalTime": "2018-11-03T05:54:00-04:00",
  "DepartureTime": "2018-11-03T07:04:00-04:00",
  "Latitude": "42.165086005554862",
  "Longitude": "-83.719882045658707",
  "HorizontalAccuracy": "33.3561806070414"
}

Was this article helpful?