Maps (your places) Schema Reference
Stay organized with collections
Save and categorize content based on your preferences.
Exported Object: Starred places
Exported Object represents: Places which were starred as a favorite.
Object is exported in these formats: GeoJSON
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 Definition | Data Field Type |
|---|
| type | Constant value "Feature". | string |
| geometry.type | Constant value "Point". | string |
| geometry.coordinates | The first element is the longitude of the place in degrees.The second element is the latitude of the place in degrees.If unknown, both longitude and latitude are 0. | array of float |
| date | The last UTC date/time this contribution was created or modified in Java ISO_INSTANT (YYYY-MM-DDTHH:mm:ssZ) format. | date |
| google_maps_url | The Google Maps URL to the place this contribution is for. | string |
| location | Metadata about the place this contribution is for. | array of object |
| location.address | The address of the place this contribution is for. | string |
| location.country_code | The ISO 3166-1 alpha-2 country code of the place this contribution is for | string |
| location.name | The name of the place this contribution is for. | string |
Exported Object: Reviews
Exported Object represents: Reviews (with or without text) left for a place.
Object is exported in these formats: GeoJSON
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 Definition | Data Field Type |
|---|
| type | Constant value "Feature". | string |
| geometry.type | Constant value "Point". | string |
| geometry.coordinates | The first element is the longitude of the place in degrees.The second element is the latitude of the place in degrees.If unknown, both longitude and latitude are 0. | array of float |
| date | The last UTC date/time this contribution was created or modified in Java ISO_INSTANT (YYYY-MM-DDTHH:mm:ssZ) format. | date |
| five_star_rating_draft | The draft (as opposed to published) 1-5 rating given. | integer |
| five_star_rating_published | The published (as opposed to draft) 1-5 rating given. | integer |
| google_maps_url | The Google Maps URL to the place this contribution is for. | string |
| location | Metadata about the place this contribution is for. | array of object |
| location.address | The address of the place this contribution is for. | string |
| location.country_code | The ISO 3166-1 alpha-2 country code of the place this contribution is for | string |
| location.name | The name of the place this contribution is for. | string |
| questions | The questions answered about the place. | array of object |
| questions.question | The question asked. | string |
| questions.selected_option | The selected answer for a multiple-choice question where a single choice is allowed. | string |
| questions.selected_options | The selected answer for a multiple-choice question where more than one choice is allowed. | array of string |
| questions.text_answer | The free-form answer given. | string |
| questions.rating | The rating answer given. | integer |
| review_text_draft | The draft (as opposed to published) text of the review. | string |
| review_text_published | The published (as opposed to draft) text of the review. | string |
A table representing Resource Groups and the objects that are exported with it.| Resource Group * | Description | Exported Objects |
|---|
| maps.reviews | This resource group contains the place reviews, ratings, and comments the user posted on Maps, plus associated metadata such as price levels. |
Reviews |
| maps.starred_places | This resource group contains places the user saved in their Starred places list on Maps. |
Starred places |
| * To obtain the OAuth Scope Name for a particular Resource Group, append "https://www.googleapis.com/auth/dataportability." to the Resource Group. For example, the OAuth Scope Name for the "myactivity.search" Resource Group is "https://www.googleapis.com/auth/dataportability.myactivity.search". |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-13 UTC.
[null,null,["Last updated 2025-02-13 UTC."],[[["\u003cp\u003eGoogle Takeout exports two types of Maps data: Starred Places and Reviews.\u003c/p\u003e\n"],["\u003cp\u003eStarred Places data includes basic location information like address, country code, and Google Maps URL.\u003c/p\u003e\n"],["\u003cp\u003eReviews data includes ratings, reviews (draft and published), answers to questions, and location details.\u003c/p\u003e\n"],["\u003cp\u003eData is exported in GeoJSON format and is accessible via specific OAuth scopes.\u003c/p\u003e\n"],["\u003cp\u003eEach data field has a defined type, such as date, string, integer, or array of objects.\u003c/p\u003e\n"]]],[],null,["# Maps (your places) Schema Reference\n\n| Data Field \\* | Field Definition | Data Field Type |\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|\n| type | Constant value \"Feature\". | string |\n| geometry.type | Constant value \"Point\". | string |\n| geometry.coordinates | The first element is the longitude of the place in degrees.The second element is the latitude of the place in degrees.If unknown, both longitude and latitude are 0. | array of float |\n| date | The last UTC date/time this contribution was created or modified in Java ISO_INSTANT (YYYY-MM-DDTHH:mm:ssZ) format. | date |\n| google_maps_url | The Google Maps URL to the place this contribution is for. | string |\n| location | Metadata about the place this contribution is for. | array of object |\n| location.address | The address of the place this contribution is for. | string |\n| location.country_code | The ISO 3166-1 alpha-2 country code of the place this contribution is for | string |\n| location.name | The name of the place this contribution is for. | string |\n[Exported Object: Starred places\nExported Object represents: Places which were starred as a favorite.\nObject is exported in these formats: GeoJSON\nExported object has the following fields:]\n\n| Data Field \\* | Field Definition | Data Field Type |\n|----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|\n| type | Constant value \"Feature\". | string |\n| geometry.type | Constant value \"Point\". | string |\n| geometry.coordinates | The first element is the longitude of the place in degrees.The second element is the latitude of the place in degrees.If unknown, both longitude and latitude are 0. | array of float |\n| date | The last UTC date/time this contribution was created or modified in Java ISO_INSTANT (YYYY-MM-DDTHH:mm:ssZ) format. | date |\n| five_star_rating_draft | The draft (as opposed to published) 1-5 rating given. | integer |\n| five_star_rating_published | The published (as opposed to draft) 1-5 rating given. | integer |\n| google_maps_url | The Google Maps URL to the place this contribution is for. | string |\n| location | Metadata about the place this contribution is for. | array of object |\n| location.address | The address of the place this contribution is for. | string |\n| location.country_code | The ISO 3166-1 alpha-2 country code of the place this contribution is for | string |\n| location.name | The name of the place this contribution is for. | string |\n| questions | The questions answered about the place. | array of object |\n| questions.question | The question asked. | string |\n| questions.selected_option | The selected answer for a multiple-choice question where a single choice is allowed. | string |\n| questions.selected_options | The selected answer for a multiple-choice question where more than one choice is allowed. | array of string |\n| questions.text_answer | The free-form answer given. | string |\n| questions.rating | The rating answer given. | integer |\n| review_text_draft | The draft (as opposed to published) text of the review. | string |\n| review_text_published | The published (as opposed to draft) text of the review. | string |\n[Exported Object: Reviews\nExported Object represents: Reviews (with or without text) left for a place.\nObject is exported in these formats: GeoJSON\nExported object has the following fields:]\n\n| Resource Group \\* | Description | Exported Objects |\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|------------------|\n| maps.reviews | This resource group contains the place reviews, ratings, and comments the user posted on Maps, plus associated metadata such as price levels. | Reviews |\n| maps.starred_places | This resource group contains places the user saved in their Starred places list on Maps. | Starred places |\n[A table representing Resource Groups and the objects that are exported with it.]"]]