Semantic Location History Format Definition¶
This page has been automatically generated from the schema Semantic.schema.json
.
Semantic Location History¶
A Semantic Location History JSON file in a Google Takeout Location History extraction. Contains Semantic Location History information from the user's account. Typically this will be a file containing data for a single month, with a name such as 2021_JANUARY.json
.
Property | Description |
---|---|
timelineObjects[] |
Timeline Objects array of: object (Timeline Object)List of all available semantic information, in chronological order. Each item in the list is either an Activity Segment or a Place Visit, encapsulated in a generic Timeline Object. |
Timeline Object¶
Encapsulates either an Activity Segment or a Place Visit, depending on the single key found.
Single Property | Description |
---|---|
activitySegment |
Activity Segment object (Activity Segment)An activity involving changes in location, usually a journey from one place to another, such as a walk, a car drive, a bus ride, or a flight. |
placeVisit |
Place Visit object (Place Visit)A visit or stay at a place in a fixed location for a duration of time, such as a stay at home, at work, a visit to a shopping mall, or to a restaurant. |
Activity Segment¶
An activity involving changes in location, usually a journey from one place to another, such as a walk, a car drive, a bus ride, or a flight.
Example
{
"activitySegment": {
"startLocation": {
"latitudeE7": 414083590,
"longitudeE7": 21704229,
"sourceInfo": {
"deviceTag": 1114211210
}
},
"endLocation": {
"latitudeE7": 413961889,
"longitudeE7": 21536695,
"sourceInfo": {
"deviceTag": 1114211210
}
},
"duration": {
"startTimestamp": "2022-03-03T12:22:24Z",
"endTimestamp": "2022-03-03T12:43:34Z"
},
"distance": 2640,
"activityType": "IN_BUS",
"confidence": "HIGH",
"activities": [
{
"activityType": "IN_BUS",
"probability": 85.6847882270813
},
{
"activityType": "WALKING",
"probability": 8.418431878089905
},
{
"activityType": "IN_PASSENGER_VEHICLE",
"probability": 2.8303226456046104
},
{
"activityType": "STILL",
"probability": 1.7383299767971039
},
{
"activityType": "IN_SUBWAY",
"probability": 0.4673520103096962
},
{
"activityType": "IN_TRAIN",
"probability": 0.3031305968761444
},
{
"activityType": "IN_TRAM",
"probability": 0.269505986943841
},
{
"activityType": "CYCLING",
"probability": 0.1483310479670763
}
],
"transitPath": {
"transitStops": [
{
"latitudeE7": 414083140,
"longitudeE7": 21704000,
"placeId": "ChIJWey1zMWipBIRiNQSzpI4EDQ",
"address": "08025 Barcelona\nEspa\u00f1a",
"name": "Sant Antoni Maria Claret-Lepant"
},
{
"latitudeE7": 414066427,
"longitudeE7": 21681608,
"placeId": "ChIJ3Wr_xsaipBIRctQDPNF0IHM",
"address": "08025 Barcelona\nEspa\u00f1a",
"name": "Sant Antoni Maria Claret - Sardenya"
},
{
"latitudeE7": 414049343,
"longitudeE7": 21659001,
"placeId": "ChIJh2lnv8CipBIRpH0ym2Bxo68",
"address": "08025 Barcelona\nEspa\u00f1a",
"name": "Sant Antoni Maria Claret - N\u00e0pols"
}
],
"name": "H8",
"hexRgbColor": "009EE0",
"linePlaceId": "ChIJQVEUoLuipBIRJO37wI4yyBs",
"stopTimesInfo": [
{
"scheduledDepartureTimestamp": "2022-03-03T12:42:00Z",
"realtimeDepartureTimestamp": "2022-03-03T12:43:37Z"
},
{
"scheduleArrivalTimestamp": "2022-03-03T12:44:01Z",
"scheduledDepartureTimestamp": "2022-03-03T12:44:01Z",
"realtimeArrivalTimestamp": "2022-03-03T12:45:38Z",
"realtimeDepartureTimestamp": "2022-03-03T12:45:38Z"
},
{
"scheduleArrivalTimestamp": "2022-03-03T12:46:03Z",
"scheduledDepartureTimestamp": "2022-03-03T12:46:03Z",
"realtimeArrivalTimestamp": "2022-03-03T12:47:40Z",
"realtimeDepartureTimestamp": "2022-03-03T12:47:40Z"
},
{
"scheduleArrivalTimestamp": "2022-03-03T12:48:00Z",
"scheduledDepartureTimestamp": "2022-03-03T12:48:00Z",
"realtimeArrivalTimestamp": "2022-03-03T12:49:37Z",
"realtimeDepartureTimestamp": "2022-03-03T12:49:37Z"
}
],
"source": "INFERRED",
"confidence": 0.9155850640140931,
"distanceMeters": 2341.0
},
"simplifiedRawPath": {
"points": [
{
"latE7": 414032766,
"lngE7": 21641819,
"accuracyMeters": 10,
"timestamp": "2022-03-03T12:27:48Z"
},
{
"latE7": 414016705,
"lngE7": 21661614,
"accuracyMeters": 13,
"timestamp": "2022-03-03T12:30:04Z"
},
{
"latE7": 413986545,
"lngE7": 21623960,
"accuracyMeters": 12,
"timestamp": "2022-03-03T12:33:51Z"
},
{
"latE7": 413976870,
"lngE7": 21610201,
"accuracyMeters": 11,
"timestamp": "2022-03-03T12:37:09Z"
},
{
"latE7": 413968976,
"lngE7": 21609892,
"accuracyMeters": 13,
"timestamp": "2022-03-03T12:38:50Z"
},
{
"latE7": 413955345,
"lngE7": 21551848,
"accuracyMeters": 11,
"timestamp": "2022-03-03T12:42:06Z"
}
],
"source": "INFERRED",
"distanceMeters": 2413.400132766728
}
}
}
Property | Description |
---|---|
activities[] |
Activities array of: object (Activity)List of all the considered candidate activity types and their probabilities. The sum of all the probabilities is always <= 100. |
activityType |
Activity Type string (Activity Type)Example: "WALKING" Best match activity type. Corresponds to the activity type with the highest probability in activities . |
confidence |
Confidence string Example: "HIGH" Confidence that the chosen activity type (see activityType ) is correct. One of: LOW , MEDIUM , HIGH or UNKNOWN_CONFIDENCE . Activities that have been manually confirmed always have a confidence of HIGH . |
distance |
Distance integer Example: 292 Distance traveled during the activity, in meters. |
duration |
|
editActionMetadata |
Edit-Action Metadata object (Edit-Action Metadata) |
editConfirmationStatus |
Edit-Confirmation Status string Example: "CONFIRMED" Whether the user has manually edited the activity segment. Can be NOT_CONFIRMED or CONFIRMED . |
endLocation |
|
lastEditedTimestamp |
Last-Edited Timestamp string (date-time )Example: "2022-03-06T14:13:11.092Z" |
parkingEvent |
Parking Event object (Parking Event) |
simplifiedRawPath |
Simplified Raw Path object (Simplified Raw Path) |
startLocation |
|
transitPath |
|
waypointPath |
Waypoint Path object (Waypoint Path) |
Place Visit¶
A visit or stay at a place in a fixed location for a duration of time, such as a stay at home, at work, a visit to a shopping mall, or to a restaurant.
Property | Description |
---|---|
centerLatE7 |
Center Latitude integer Example: 414216106 Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
centerLngE7 |
Center Longitude integer Example: 21684775 Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
checkin |
Checkin object (Checkin) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. |
childVisits[] |
Child Visits array of: object (Place Visit) |
duration |
|
editActionMetadata |
Edit-Action Metadata object (Edit-Action Metadata) |
editConfirmationStatus |
Edit-Confirmation Status string Example: "CONFIRMED" Whether the user has manually edited the place visit. Can be NOT_CONFIRMED or CONFIRMED . |
lastEditedTimestamp |
Last-Edited Timestamp string (date-time )Example: "2022-03-06T14:13:11.092Z" |
location |
|
locationAssertionType |
Location Assertion Type string Example: "AREA" |
locationConfidence |
Visit Confidence integer Example: 71 |
otherCandidateLocations[] |
Other Candidate Locations array of: object (Location) |
placeConfidence |
Place Confidence string Example: "HIGH" Categorized confidence for this place visit. One of: LOW_CONFIDENCE , MEDIUM_CONFIDENCE , HIGH_CONFIDENCE or USER_CONFIRMED . Help Wanted: Is this directly related to locationConfidence and/or visitConfidence Contributions to improve this are welcome. |
placeVisitImportance |
Place Visit Importance string Example: "MAIN" One of MAIN or TRANSITIONAL . |
placeVisitLevel |
Place Visit Level integer Example: 1 Level (depth) of this place visit. This value increases by 1 with each recursive access to a childVisits entry. |
placeVisitType |
Place Visit Type string Example: "SINGLE_PLACE" Can be SINGLE_PLACE . Help Wanted: Are there other valid values? Contributions to improve this are welcome. |
sectionId |
Section ID string |
simplifiedRawPath |
Simplified Raw Path object (Simplified Raw Path) |
visitConfidence |
Visit Confidence integer Example: 95 Help Wanted: How is this different from locationConfidence Contributions to improve this are welcome. |
Activity¶
Example
{
"activityType": "WALKING",
"probability": 95.93904614448547
}
Property | Description |
---|---|
activityType |
|
probability |
Probability number Example: 95.93904614448547 Probability (or confidence) that the activity type is correct, in the range 0 to 100. |
Activity Type¶
Activity Type | Description |
---|---|
BOATING |
Boating |
CATCHING_POKEMON |
Catching Pokémon |
CYCLING |
Cycling |
FLYING |
Flying |
HIKING |
Hiking |
HORSEBACK_RIDING |
Horseback riding |
IN_BUS |
On a bus |
IN_CABLECAR |
In a cable car |
IN_FERRY |
On a ferry |
IN_FUNICULAR |
On a funicular |
IN_GONDOLA_LIFT |
In a gondola lift |
IN_PASSENGER_VEHICLE |
Driving |
IN_SUBWAY |
On the subway |
IN_TAXI |
In a taxi |
IN_TRAIN |
On a train |
IN_TRAM |
On a tram |
IN_VEHICLE |
In a vehicle |
IN_WHEELCHAIR |
By wheelchair |
KAYAKING |
Kayaking |
KITESURFING |
Kitesurfing |
MOTORCYCLING |
Motorcycling |
PARAGLIDING |
Paragliding |
ROWING |
Rowing |
RUNNING |
Running |
SAILING |
Sailing |
SKATEBOARDING |
Skateboarding |
SKATING |
Skating |
SKIING |
Skiing |
SLEDDING |
Sledding |
SNOWBOARDING |
Snowboarding |
SNOWMOBILE |
Snowmobiling |
SNOWSHOEING |
Snowshoeing |
STILL |
Still |
SURFING |
Surfing |
SWIMMING |
Swimming |
UNKNOWN_ACTIVITY_TYPE |
Moving |
WALKING |
Walking |
WALKING_NORDIC |
Nordic walking |
Duration¶
Duration of time defined by a start timestamp and an end timestamp.
Example
{
"startTimestamp": "2022-02-02T10:41:08.315Z",
"endTimestamp": "2022-02-02T10:45:09.962Z"
}
Property | Description |
---|---|
endTimestamp |
End Timestamp string (date-time )Example: "2022-02-02T10:45:09.962Z" |
startTimestamp |
Start Timestamp string (date-time )Example: "2022-02-02T10:41:08.315Z" |
Edit-Action Metadata¶
Property | Description |
---|---|
activitySegment |
Activity Segment object (Activity Segment) |
editHistory |
Edit History object (Edit History) |
originalCandidates |
Original Candidates object (Original Candidates) |
placeVisitSegment |
Place Visit Segment object (Place Visit Segment) |
Location¶
Example
{
"latitudeE7": 414036299,
"longitudeE7": 21743558,
"placeId": "ChIJk_s92NyipBIRUMnDG8Kq2Js",
"address": "C/ de Mallorca, 401\n08013 Barcelona\nEspanya",
"name": "La Sagrada Familia",
"semanticType": "TYPE_SEARCHED_ADDRESS",
"sourceInfo": {
"deviceTag": 1234567890
},
"locationConfidence": 87.07311,
"calibratedProbability": 76.20023
}
Property | Description |
---|---|
accuracyMetres |
Accuracy in meters integer Example: 19 Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. |
address |
Address string Example: "C/ de Mallorca, 401\n08013 Barcelona\nEspanya" Address of the location. |
calibratedProbability |
Calibrated Probability number Example: 100.0 |
isCurrentLocation |
Is Current Location boolean Example: true |
latitudeE7 |
Latitude integer Example: 414216106 Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
locationConfidence |
Location Confidence number Example: 100.0 |
longitudeE7 |
Longitude integer Example: 21684775 Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
name |
Name string Example: "La Sagrada Familia" Name of the location. |
placeId |
|
semanticType |
Semantic Type string (Semantic Type)Example: "TYPE_HOME" Place type based on semantic information specific to the user. |
sourceInfo |
Parking Event¶
Example
{
"location": {
"latitudeE7": 412518975,
"longitudeE7": 21683133,
"accuracyMetres": 19
},
"method": "EXITING_VEHICLE_SIGNAL",
"locationSource": "FROM_RAW_LOCATION",
"timestamp": "2022-02-27T14:47:16.731Z"
}
Property | Description |
---|---|
location |
Location object (Location) |
locationSource |
Location Source string Example: "FROM_RAW_LOCATION" |
method |
Method string Example: "EXITING_VEHICLE_SIGNAL" |
timestamp |
Timestamp string (date-time )Example: "2022-02-27T14:47:16.731Z" |
Simplified Raw Path¶
Example
{
"points": [
{
"latE7": 416032766,
"lngE7": 21841819,
"accuracyMeters": 10,
"timestamp": "2022-03-03T08:27:48Z"
},
{
"latE7": 416016705,
"lngE7": 21861614,
"accuracyMeters": 13,
"timestamp": "2022-03-03T08:30:04Z"
},
{
"latE7": 415986545,
"lngE7": 21823960,
"accuracyMeters": 12,
"timestamp": "2022-03-03T08:33:51Z"
}
],
"source": "INFERRED",
"distanceMeters": 2413.400132766728
}
Property | Description |
---|---|
distanceMeters |
Distance in meters number Example: 2413.400132766728 Distance traveled with the path, in meters. |
points[] |
|
source |
Source string Example: "INFERRED" Source of the location data of the path. One of BACKFILLED , INFERRED , or RESNAPPED_FOR_EDIT . |
Transit Path¶
A path taken in a public transit system, such as a bus or a metro. Note that it does not describe an entire transit line, but only a specific journey a user does in a transit line.
Example
{
"transitStops": [
{
"latitudeE7": 414083140,
"longitudeE7": 21704000,
"placeId": "ChIJWey1zMWipBIRiNQSzpI4EDQ",
"address": "08025 Barcelona\nEspa\u00f1a",
"name": "Sant Antoni Maria Claret-Lepant"
},
{
"latitudeE7": 414066427,
"longitudeE7": 21681608,
"placeId": "ChIJ3Wr_xsaipBIRctQDPNF0IHM",
"address": "08025 Barcelona\nEspa\u00f1a",
"name": "Sant Antoni Maria Claret - Sardenya"
},
{
"latitudeE7": 414049343,
"longitudeE7": 21659001,
"placeId": "ChIJh2lnv8CipBIRpH0ym2Bxo68",
"address": "08025 Barcelona\nEspa\u00f1a",
"name": "Sant Antoni Maria Claret - N\u00e0pols"
}
],
"name": "H8",
"hexRgbColor": "009EE0",
"linePlaceId": "ChIJQVEUoLuipBIRJO37wI4yyBs",
"stopTimesInfo": [
{
"scheduledDepartureTimestamp": "2022-03-03T12:42:00Z",
"realtimeDepartureTimestamp": "2022-03-03T12:43:37Z"
},
{
"scheduleArrivalTimestamp": "2022-03-03T12:44:01Z",
"scheduledDepartureTimestamp": "2022-03-03T12:44:01Z",
"realtimeArrivalTimestamp": "2022-03-03T12:45:38Z",
"realtimeDepartureTimestamp": "2022-03-03T12:45:38Z"
},
{
"scheduleArrivalTimestamp": "2022-03-03T12:46:03Z",
"scheduledDepartureTimestamp": "2022-03-03T12:46:03Z",
"realtimeArrivalTimestamp": "2022-03-03T12:47:40Z",
"realtimeDepartureTimestamp": "2022-03-03T12:47:40Z"
},
{
"scheduleArrivalTimestamp": "2022-03-03T12:48:00Z",
"scheduledDepartureTimestamp": "2022-03-03T12:48:00Z",
"realtimeArrivalTimestamp": "2022-03-03T12:49:37Z",
"realtimeDepartureTimestamp": "2022-03-03T12:49:37Z"
}
],
"source": "INFERRED",
"confidence": 0.9155850640140931,
"distanceMeters": 2341.0
}
Property | Description |
---|---|
confidence |
Confidence number Example: 0.9155850640140931 |
distanceMeters |
Distance in meters number Example: 396.34176716755843 Distance traveled with the transit path, in meters. |
hexRgbColor |
Hexadecimal RGB Color string Example: "009EE0" Color of the transit line in hexadecimal in the form RRGGBB. |
linePlaceId |
|
name |
Name string Example: "H8" Name of the transit line. |
source |
Source string Example: "INFERRED" Source of the location data of the transit path. Either BACKFILLED or INFERRED . |
stopTimesInfo[] |
Stop Times Info array of: object (Stop Time Info)Time information (departure and arrival times, both real and scheduled) for each transit stop used. |
transitStops[] |
Waypoint Path¶
Example
{
"waypoints": [
{
"latE7": 416119834,
"lngE7": 21768624
},
{
"latE7": 416117012,
"lngE7": 21899302
},
{
"latE7": 416119262,
"lngE7": 21802315
}
],
"source": "INFERRED",
"distanceMeters": 396.34176716755843,
"travelMode": "WALK",
"confidence": 0.7986568220419046
}
Property | Description |
---|---|
confidence |
Confidence number Example: 0.7986568220419046 |
distanceMeters |
Distance in meters number Example: 396.34176716755843 Total distance of the path, in meters. |
roadSegment[] |
Road Segment array of: object (Road Segment) |
source |
Source string Example: "INFERRED" Source of the location data of the path. Either BACKFILLED or INFERRED . |
travelMode |
Travel Mode string Example: "WALK" |
waypoints[] |
Waypoints array of: object (Waypoint) |
Checkin¶
Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome.
Property | Description |
---|---|
atTime |
At Time string (date-time )Example: "2022-03-06T14:13:11.092Z" |
device |
Device object (Device) |
latestKnownLocation |
Latest Known Location object (Latest Known Location) |
Activity Segment¶
Property | Description |
---|---|
activityConfidence |
Confidence number Example: 98.705695 |
activityType |
Activity Type string (Activity Type)Example: "WALKING" |
Edit History¶
Property | Description |
---|---|
editEvent[] |
Edit Event array of: object (Edit Event) |
Original Candidates¶
Property | Description |
---|---|
placeVisitSegment |
Place Visit Segment object (Place Visit Segment) |
Place Visit Segment¶
Property | Description |
---|---|
location |
Location object (Location) |
Semantic Type¶
Place type based on semantic information specific to the user.
Semantic Type | Description |
---|---|
TYPE_ALIASED_LOCATION |
Type Aliased Location The place has been given a private label by the user. See: Give a place a private label. |
TYPE_HOME |
Type Home The place has been designated as 'Home' by the user. See: Set or change your home & work addresses. |
TYPE_SEARCHED_ADDRESS |
Type Searched Address The user has searched for this place in the past. |
TYPE_WORK |
Type Work The place has been designated as 'Work' by the user. See: Set or change your home & work addresses. |
Source Information¶
Information on the source that provided the location.
Property | Description |
---|---|
deviceTag |
Device Tag integer Example: 1234567890 Integer identifier (specific to Location History) associated with the device that obtained the location. Refer to deviceSettings in Settings.json for information about the device with this deviceTag . |
Point¶
Example
{
"latE7": 416032766,
"lngE7": 21841819,
"accuracyMeters": 10,
"timestamp": "2022-03-03T08:27:48Z"
}
Property | Description |
---|---|
accuracyMeters |
Accuracy in meters integer Example: 10 Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. |
latE7 |
Latitude integer Example: 414216106 Latitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
lngE7 |
Longitude integer Example: 21684775 Longitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
timestamp |
Timestamp string (date-time )Example: "2022-03-03T08:27:48Z" Timestamp of the point. |
Stop Time Info¶
Departure and/or arrival time information (both real and scheduled) for a stop at a transit line.
Example
{
"scheduleArrivalTimestamp": "2022-03-03T12:44:01Z",
"scheduledDepartureTimestamp": "2022-03-03T12:44:01Z",
"realtimeArrivalTimestamp": "2022-03-03T12:45:38Z",
"realtimeDepartureTimestamp": "2022-03-03T12:45:38Z"
}
Property | Description |
---|---|
realtimeArrivalTimestamp |
Realtime Arrival Timestamp string (date-time )Example: "2022-03-03T12:45:38Z" |
realtimeDepartureTimestamp |
Realtime Departure Timestamp string (date-time )Example: "2022-03-03T12:45:38Z" |
scheduleArrivalTimestamp |
Schedule Arrival Timestamp string (date-time )Example: "2022-03-03T12:44:01Z" |
scheduledDepartureTimestamp |
Scheduled Departure Timestamp string (date-time )Example: "2022-03-03T12:44:01Z" |
Road Segment¶
Property | Description |
---|---|
duration |
Duration string Example: "8s" |
placeId |
Waypoint¶
Example
{
"latE7": 414216106,
"lngE7": 21684775
}
Property | Description |
---|---|
latE7 |
Latitude integer Example: 414216106 Latitude coordinate of the waypoint. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
lngE7 |
Longitude integer Example: 21684775 Longitude coordinate of the waypoint. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
Device¶
Property | Description |
---|---|
android |
Android object (Android) |
Latest Known Location¶
Property | Description |
---|---|
detectionTime |
Detection Time string (date-time )Example: "2022-03-06T14:13:11.092Z" |
location |
Location object (Location) |
Edit Event¶
Property | Description |
---|---|
editOperation[] |
Edit Operation array of: string |
uiConfiguration |
UI Configuration object (UI Configuration) |
Place Visit Segment¶
Property | Description |
---|---|
placeVisitCandidate[] |
Place Visit Candidate array of: object (Original Candidates) |
Android¶
Property | Description |
---|---|
fingerprint |
Fingerprint string |
UI Configuration¶
Property | Description |
---|---|
uiActivitySegmentConfiguration |
UI Activity Segment Configuration string Example: "DEFAULT_ACTIVITY_SEGMENT_CONFIGURATION" |
uiPlaceVisitConfiguration |
UI Place Visit Configuration string Example: "DEFAULT_PLACE_VISIT_CONFIGURATION" |
Original Candidates¶
Property | Description |
---|---|
location |
Location object (Location) |