Maps Schema Reference

Exported Object: Added dishes, products, activities.
Exported Object represents: Dishes, products, activities you added to places in Maps.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
photoUrlThe URL of the photo with the corresponding tag.string
tagTextThe text of your original contribution that indicated what dish, product, or activity was in the photo.string
creationTimeSubmission time of the contribution in UTC timezone, formatted in ISO-8601 format.string
Exported Object: Aliased Places
Exported Object represents: Your pinned locations on Maps
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
featuresA list of pinned locations.list of feature object
feature.geometryGeographical data for the pinned location.Geometry object
geometry.coordinatesCoordinates of the pinned location. latlng object
geometry.typeType of the geometry object (should be Point). string
feature.propertyMetadata associated with the pinned location. Property object
property.nameIdentifier associated with the pinned location. string
property.addressIf possible, provides an address for the pinned location string
Exported Object: Answers to automated questions
Exported Object represents: Your answers to automated questions from Google Maps.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
place_urlThe Google Maps URL of the place that is the subject of the question.string
questionThe question that was asked.string
selected_choiceFor multiple choice questions, your selected answer.string
answerFor yes or no questions, whether you selected yes, no, or unsure.string
Exported Object: Commute routes
Exported Object represents: Your pinned trips on Maps, including routes, destinations, and modes of transportation.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
tripsA list of pinned trips.list of trip object
trip.idA unique identifier of the trip.

Examples:
3DAEF1A60A3310F1
commute_to_home
string
trip.recurrenceThe regular pattern on which the trip takes place.recurrence object
recurrence.weekly_patternThe weekly pattern on which the trip takes place.weeklypattern object
weeklypattern.dayThe days of the week on which the trip takes place.list of dailyinstance object
dailyinstance.dayA day of the week, corresponding to ISO8601 weekdays. The day is consecutively numbered starting with Monday=1 and Tuesday=2, to Sunday=7.integer
trip.place_visitAn ordered list of places visited during the trip.list of placevisit object
placevisit.idAn identifier of the placevisit. This is unique in the trip.list
placevisit.arrival_timingOptional timing information for arriving at the destination.timerequirement object
placevisit.departure_timingOptional timing information for departing the origin.timerequirement object
timerequirement.timeThe time of day without a time-zone.timeofday object
timeofday.hourThe hour of the day between 0 and 23.integer
timeofday.minuteThe minute of the hour between 0 and 59.integer
placevisit.placeThe place involved in the placevisit. When absent, this refers to the user location when the query is run.place object
place.semantic_typeThe type of the place: home, work, or unknown.

Examples:
TYPE_HOME
TYPE_WORK
TYPE_UNKNOWN
string
place.lat_lngThe position of the place. This is omitted for home and work.latlng object
latlng.latitudeThe latitude of the place in degrees.double
latlng.longitudeThe longitude of the place in degrees.double
trip.transitionThis describes how the user transitions between place visits.list of transition object
transition.originThe origin (start) point of the transition.endpoint object
transition.destinationThe destination (end) point of the transition.endpoint object
endpoint.visit_idA placevisit identifier.string
transition.routeThe optional route for the transition. This describes how to travel between the origin and the destination.route object
route.travel_modeThe overall travel mode of the route.

Examples:
DRIVE
TRANSIT
TWO_WHEELER
BICYCLE
string
route.transitThis describes the route when it involves transit.transit object
transit.legA sequence of legs of the transit journey.list of leg object
leg.modeThe travel mode of the leg.

Examples:
WALKING
TRANSIT
string
leg.destinationThe name of the transit stop or station at the end of the leg. This is omitted for the final leg.

Examples:
King's Cross
Shinjuku
string
Exported Object: Commute settings
Exported Object represents: Your commute settings, such as the preferred mode of transportation.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
commuteModeThe mode of transportation used for commuting between home and work.

Examples:
DRIVE
TRANSIT
WALKING
BIKING
TWO_WHEELER
string
otherTravelModeThe generally preferred mode of transportation.

Examples:
DRIVE
TRANSIT
WALKING
BIKING
TWO_WHEELER
string
Exported Object: Electric vehicle profile.
Exported Object represents: The electric vehicle profile you created in Maps.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
nameThe name of the profilestring
preferred_connector_type_nameThe connector types marked as preferred in the profile.array of string
Exported Object: Geocode contributions
Exported Object represents: The geocodes you added to Google Maps.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
geocodes.pointThe latitude and longitude coordinates associated with this geocode.lat-lng object
geocodes.addressThe address associated with this geocode.text-language object
Exported Object: Instructions
Exported Object represents: Instructions that you sent to Google Maps.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
instructions.location.direction_info.step_descriptionThe direction step you received when you issued this instruction.string
instructions.location.pointsYour approximate location when you issued this instruction.lat-lng object
instructions.instruction_typeThe type of this instruction.

Examples:
SUSPECTED_DUPLICATE
ROAD_NAME
ROAD_CLOSED
ROAD_MISSING
GEOCODE_PROBLEM
string
instructions.related_place_urlsThe Google Maps URLs of places related to this instruction.string
instructions.name_update.old_valueThe old place name that you removed.text-language object
instructions.name_update.new_valueThe new place name that you added.text-language object
instructions.point_update.new_valueThe new place location that you added.lat-lng object
instructions.address_update.new_valueThe new place address that you added.text-language object
instructions.duplicate_update.place_urlThe Google Maps URL of a place that you identified as a duplicate place.string
instructions.road_closure_update.closing_timeThe timestamp when the road is closing.

Examples:
2023-11-09T10:00
2023-11-09T10:05:28Z
ISO 8601 timestamp string
instructions.road_closure_update.reopening_timeThe timestamp when the road is reopening.

Examples:
2023-11-09T14:00
ISO 8601 timestamp string
instructions.road_closure_update.primary_causeThe primary cause of the road closure.

Examples:
CONSTRUCTION
CRASH
NATURE
EVENT
CAUSE_OTHER
string
instructions.road_closure_update.nature_causeA more specific cause for the road closure if the main cause is "NATURE".

Examples:
FLOOD
EARTHQUAKE
FIRE
MUDSLIDE
SNOW_ICE
TREE
NATURE_OTHER
string
instructions.road_closure_update.directionThe directionality of the road closure.

Examples:
ONE_WAY_DIRECTION_UNDEFINED
TWO_WAY
string
instructions.road_network_update.before.segments.nameThe road segment name before your edit.text-language object
instructions.road_network_update.before.segments.polyline.verticesThe road segment vertices before your edit.lat-lng object
instructions.road_network_update.before.segments.road_coarse_categoryThe road segment category before your edit.

Examples:
NORMAL_ROAD
HIGHWAY
PARKING_LOT
NON_TRAFFIC_TRAIL
string
instructions.road_network_update.before.segments.place_urlFor existing road segments, the Google Maps URL of the road segment.string
instructions.road_network_update.before.segments.diff_typeWhether this road segment is being deleted or modified.

Examples:
NO_DIFF
BEFORE_EDIT
DELETE
string
instructions.road_network_update.after.segments.nameThe road segment name after your edit.text-language object
instructions.road_network_update.after.segments.polyline.verticesThe road segment vertices after your edit.lat-lng object
instructions.road_network_update.after.segments.road_coarse_categoryThe road segment category after your edit.

Examples:
NORMAL_ROAD
HIGHWAY
PARKING_LOT
NON_TRAFFIC_TRAIL
string
instructions.road_network_update.after.segments.place_urlFor existing road segments, the Google Maps URL of the road segment.string
instructions.road_network_update.after.segments.diff_typeWhether this road segment is being added or modified.

Examples:
NO_DIFF
ADD
AFTER_EDIT
string
instructions.user_commentsComments you attached to the instruction. They are removed after the expiration period.text-language object
Exported Object: Photos Contribution
Exported Object represents: Photos or videos you added to places on Maps.
Object is exported in these formats: JSON Original Format JPG/PNG/MP4
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
titleThe image filename.string
descriptionThe image caption.string
imageViewsThe total number of views.int
creationTime.timestampThe time when this photo or video was uploaded.timestamp
creationTime.formattedThe formatted time when this photo or video was uploaded.string
photoTakenTime.timestampThe time when this photo or video was taken.timestamp
photoTakenTime.formattedThe formatted time when this photo or video was taken.string
geoDataExif.latitudeThe latitude in degrees.double
geoDataExif.longitudeThe longitude in degrees.double
geoDataExif.altitudeThe altitude in meters, offset from WGS84.double
geoDataExif.latitudeSpanThis defines a bounding box (latitude +/- latitudeSpan).double
geoDataExif.longitudeSpanThis defines a bounding box (longitude +/- longitudeSpan).double
Exported Object: Questions and Answers
Exported Object represents: Questions and answers you posted in Maps.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
answersA list of answers you submitted in Maps.list
questionsA list of questions you submitted in Maps.list
repliesA list of replies you submitted in Maps.list
thumb_upsA list of thumbs up you submitted in Maps.list
place_urlA link to the place in Maps where the content was posted.string
textThe text contributions you posted such as questions, answers, and replies.string
has_best_answerWhether the posted question has a selected answer as the best answer.boolean
up_countThe total number of thumbs up you posted for the given place.int
Exported Object: Suggested edits to business establishments
Exported Object represents: Your suggested edits to business establishments.
Object is exported in these formats: JSON
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
edit_actionWhether you suggested adding a new place or modifying an existing place.

Examples:
ADD_PLACE_ACTION
MODIFY_PLACE_ACTION
string
place_urlThe Google Maps URL of the place you edited.string
name_change.operations.typeWhether this operation is setting, adding, or deleting a name.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
name_change.operations.textThe name you set, added, or deleted.text-language object
point_change.operations.typeWhether this operation is setting, adding, or deleting a location in latitude and longitude.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
point_change.operations.pointThe latitude and longitude of the location you set, added, or deleted.lat-lng object
business_existence_change.operations.typeWhether this operation is setting, adding, or deleting a business status.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
business_existence_change.operations.business_existenceThe business status you set, added, or deleted.

Examples:
OPEN
CLOSED_PERMANENTLY
CLOSED_TEMPORARILY
CLOSED_UNKNOWN
MOVED
REBRANDED
string
place_existence_change.operations.typeWhether this operation is setting, adding, or deleting a place status.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
place_existence_change.operations.place_existenceThe place status you set, added, or deleted.

Examples:
LIVE
PENDING
BOGUS
PRIVATE
SPAM
DUPLICATE
REMOVED_REASON_UNKNOWN
string
category_change.operations.typeWhether this operation is setting, adding, or deleting a category.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
category_change.operations.category.The category you set, added, or deleted.string
address_change.operations.typeWhether this operation is setting, adding, or deleting an address.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
address_change.operations.addressThe address you set, added, or deleted.text-language object
website_change.operations.typeWhether this operation is setting, adding, or deleting a website.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
website_change.operations.website.urlThe URL of the website you set, added, or deleted.string
website_change.operations.website.languageThe language of the website you set, added, or deleted.string
website_change.operations.website.anchor_textThe URL anchor text of the website you set, added, or deleted.text-language object
phone_number_change.operations.typeWhether this operation is setting, adding, or deleting a phone number.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
phone_number_change.operations.phone_numberThe phone number you set, added, or deleted.string
business_opening_date_change.operations.typeWhether this operation is setting, adding, or deleting the opening date of the business.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
business_opening_date_change.operations.business_opening_dateThe business opening date you set, added, or deleted. The date is in this format: YYYY-MM-DD.

Examples:
1998-09-04
NEAR_FUTURE
string
regular_business_hours_change.operations.typeWhether this operation is setting, adding, or deleting regular business hours.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
regular_business_hours_change.operations.regular_business_hours.open_intervals.opening_timeThe opening time of this regular business hours interval. The opening time is in this format: DAY_OF_WEEK HH:mm:ss.

Examples:
MONDAY 09:00:00
string
regular_business_hours_change.operations.regular_business_hours.open_intervals.closing_timeThe closing time of this regular business hours interval. The closing time is in this format: DAY_OF_WEEK HH:mm:ss.

Examples:
MONDAY 17:00:00
string
exceptional_business_hours_change.operations.typeWhether this operation is setting, adding, or deleting exceptional business hours.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
exceptional_business_hours_change.operations.exceptional_business_hours.dateThe date of the exceptional business hours you set, added, or deleted. The date is in this format: YYYY-MM-DD.

Examples:
2023-12-25
string
exceptional_business_hours_change.operations.exceptional_business_hours.open_hours.opening_timeThe business opening time for the given date. The opening time is in this format: HH:mm:ss.

Examples:
09:00:00
string
exceptional_business_hours_change.operations.exceptional_business_hours.open_hours.closing_timeThe business closing time for the given date. The closing time is in this format: (YYYY-MM-DD) HH:mm:ss.

Examples:
17:00:00
2023-12-26 01:00:00
string
exceptional_business_hours_change.operations.exceptional_business_hours.is_closedWhen set to true, this indicates that the business is closed for the given date.boolean
secondary_business_hours_changes.hours_typeThe type of the secondary business hours.

Examples:
HAPPY_HOUR
DELIVERY
TAKEOUT
LUNCH
string
secondary_business_hours_changes.operations.typeWhether this operation is setting, adding, or deleting secondary business hours.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
secondary_business_hours_changes.operations.secondary_business_hours.open_intervals.opening_timeThe opening time of this secondary business hours interval. The opening time is in this format: DAY_OF_WEEK HH:mm:ss.

Examples:
MONDAY 09:00:00
string
secondary_business_hours_changes.operations.secondary_business_hours.open_intervals.closing_timeThe closing time of this secondary business hours interval. The closing time is in this format: DAY_OF_WEEK HH:mm:ss.

Examples:
MONDAY 17:00:00
string
relation_changes.relation_typeThe type of the relation.

Examples:
RELATION_CONTAINED_BY
RELATION_DEPARTMENT_OF
RELATION_WORKS_AT
RELATION_INDEPENDENT_ESTABLISHMENT_IN
RELATION_BUSINESS_MOVED
RELATION_BUSINESS_REBRANDED
RELATION_MEMBER_OF_CHAIN
string
relation_changes.operations.typeWhether this operation is setting, adding, or deleting a relation.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
relation_changes.operations.related_place_urlThe Google Maps URL of the place that is related to the place you are editing.string
attachment_changes.operations.typeWhether this operation is setting, adding, or deleting an attachment.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
attachment_changes.operations.attachment.client_name_spaceThe attachment client namespace that indicates the source of the attachment.string
attachment_changes.operations.attachment.payload_stringThe attachment payload in JSON format.string
attachment_changes.operations.attachment.payload_bytesIf the attachment payload cannot be parsed as a JSON, fall back to returning it in bytes.bytes
merchant_description_change.operations.typeWhether this operation is setting, adding, or deleting a merchant description.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
merchant_description_change.operations.textThe merchant description you set, added, or deleted.text-language object
simple_attribute_boolean_changes.simple_attribute_idThe ID of a generic attribute that contains a boolean.

Examples:
/geo/type/establishment_poi/has_takeout
string
simple_attribute_boolean_changes.operations.typeWhether this operation is setting, adding, or deleting a generic attribute.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
simple_attribute_boolean_changes.operations.simple_attribute_booleanThe generic attribute boolean you set, added, or deleted.boolean
simple_attribute_enum_changes.simple_attribute_idThe ID of a generic attribute that contains an enum.

Examples:
/geo/type/establishment/price_level
string
simple_attribute_enum_changes.operations.typeWhether this operation is setting, adding, or deleting a generic attribute.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
simple_attribute_enum_changes.operations.simple_attribute_enumThe generic attribute enum you set, added, or deleted.string
simple_attribute_url_changes.simple_attribute_idThe ID of a generic attribute that contains a URL.

Examples:
/geo/type/establishment_poi/url_order_ahead
string
simple_attribute_url_changes.operations.typeWhether this operation is setting, adding, or deleting a generic attribute.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
simple_attribute_url_changes.operations.simple_attribute_urlThe generic attribute URL you set, added, or deleted.string
vanity_lookup_name_change.operations.typeWhether this operation is setting, adding, or deleting a vanity name in raw form.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
vanity_lookup_name_change.operations.vanity_nameThe raw form of the vanity name you set, added, or deleted.string
vanity_display_name_change.operations.typeWhether this operation is setting, adding, or deleting the display form of a vanity name.

Examples:
SET_OPERATION
ADD_OPERATION
DELETE_OPERATION
IMPLICIT_DELETE_OPERATION
ASSERT_UNSURE_OPERATION
string
vanity_display_name_change.operations.vanity_nameThe display form of the vanity name you set, added, or deleted.string
metadata.create_timeThe timestamp when you suggested this edit.

Examples:
2023-11-09T19:51:38Z
ISO 8601 timestamp string
A table representing Resource Groups and the objects that are exported with it.
Resource GroupOAuth Scope NameDescriptionExported Objects
maps.aliased_placeshttps://www.googleapis.com/auth/dataportability.maps.aliased_placesThis resource group contains the places the user saved with a custom label.
Aliased Places
maps.commute_routeshttps://www.googleapis.com/auth/dataportability.maps.commute_routesThis resource group contains the user's pinned trips on Maps, including routes, destinations, and modes of transportation.
Commute routes
maps.commute_settingshttps://www.googleapis.com/auth/dataportability.maps.commute_settingsThis resource group contains the user's commute settings, such as the preferred mode of transportation.
Commute settings
maps.ev_profilehttps://www.googleapis.com/auth/dataportability.maps.ev_profileThis resource group contains data about the user's electric vehicle, such as the charging plug type.
Electric vehicle profile.
maps.factual_contributionshttps://www.googleapis.com/auth/dataportability.maps.factual_contributionsThis resource group contains all the place edits and map edits the user made on Maps.
Geocode contributions
Instructions
Answers to automated questions
Suggested edits to business establishments
maps.offering_contributionshttps://www.googleapis.com/auth/dataportability.maps.offering_contributionsThis resource group contains the updates the user made to places on Maps, such as the dishes, products, and activities offered.
Added dishes, products, activities.
maps.photos_videoshttps://www.googleapis.com/auth/dataportability.maps.photos_videosThis resource group contains the photos and videos the user posted of places on Maps, plus associated metadata such as time of upload.
Photos Contribution
maps.questions_answershttps://www.googleapis.com/auth/dataportability.maps.questions_answersThis resource group contains the questions and answers the user posted about places on Maps, plus associated metadata such as time of upload.
Questions and Answers