RKStudio™
User Guide

Apple Location Visits

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.

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.
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 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
{
  "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"
}