# Takeout feature to export our data

**URL:** <https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928>\
**Category:** Uncategorized\
**Created:** [March 26, 2024, 8:48am UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928 "2024-03-26T08:48:17Z")\
**Posts on this page:** 18\
**Page:** 1

<div class="post-metadata">

**Author:** ![tykayn](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/tykayn/32/72257_2.png) [@tykayn](https://forum.mapillary.com/u/tykayn)\
**Post date:** [March 26, 2024, 8:48am UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/1 "2024-03-26T08:48:17Z")

</div>

Hi there, the GDPR states that every website collecting user data should give to its users a way to massively export their data in a simple way (not a command line tool, which there is not either). Facebook and Google has this feature to request an archive containing pictures and json data, why is there nothing like this on Mapillary?

This is a big problem as more and more people want to have a proper backup with exif data inside of their photos, to import it to other services like [panoramax](https://panoramax.openstreetmap.fr) or whatever, but no way to do so.  
Who can reach the developer team to comply with law and hear their userbase? Should we unionize with some authority to have this feature which is mandatory in Europe since 2016, nearly 10 years ago?

---

<div class="post-metadata">

**Author:** ![googie](https://avatars.discourse-cdn.com/v4/letter/g/d6d6ee/32.png) [@googie](https://forum.mapillary.com/u/googie)\
**Post date:** [March 27, 2024, 2:04pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/2 "2024-03-27T14:04:55Z")

</div>

why don’t you contact facebook you mentioned. they own mapillary, don’t they?

---

<div class="post-metadata">

**Author:** ![tykayn](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/tykayn/32/72257_2.png) [@tykayn](https://forum.mapillary.com/u/tykayn)\
**Post date:** [March 27, 2024, 3:17pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/3 "2024-03-27T15:17:23Z")

</div>

@googie i did wrote to the support a few years ago about that, but they just never answered. So i hope that if a few people have feedback about a similar experience it would be easier to get it to work more quickly

---

<div class="post-metadata">

**Author:** ![boris](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/boris/32/71767_2.png) [@boris](https://forum.mapillary.com/u/boris)\
**Post date:** [April 3, 2024, 12:38pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/4 "2024-04-03T12:38:30Z")

</div>

Hi @tykayn, FYI that while there is no UI, you can get all of the images you have uploaded to Mapillary using the “creator” field in the API and the thumb\_original\_url  
field: [API Documentation](https://www.mapillary.com/developer/api-documentation#image)

---

<div class="post-metadata">

**Author:** ![MossTown](https://avatars.discourse-cdn.com/v4/letter/m/90ced4/32.png) [@MossTown](https://forum.mapillary.com/u/MossTown)\
**Post date:** [April 20, 2024, 3:46am UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/5 "2024-04-20T03:46:32Z")

</div>

First, the download\_images.py program was deleted during a “Python3 support” pull request:

> <https://github.com/mapillary/mapillary_tools/commit/5bcc2f5f8ccfd5786c35ff18a0f161dc9adc5f3e>
>
> \* fix: remove old upload API
> 
> \* use requests
> 
> \* feat: py3 compatible
> 
> \* mo…re py3 compatible
> 
> \* chore: format by black
> 
> \* fix undefined variables
> 
> \* format bin/\*.py using black
> 
> \* use requests for downloading
> 
> \* refactor
> 
> \* update requirements.txt and setup.py
> 
> \* fix exif tests
> 
> \* move mapillary\_tools/test to /tests/unit
> 
> \* Create python-package.yml
> 
> \* test more platforms
> 
> \* use relative imports
> 
> \* remove --api\_version
> 
> \* refactor authenticate
> 
> \* move api v3 out from some modules
> 
> \* remove bin/ and add mapillary\_tools as entry point
> 
> \* fix CI
> 
> \* update README
> 
> \* clean up files
> 
> \* refactor: convert format to f-string with flynt
> 
> flynt -ll 300 mapillay\_tools tests
> 
> \* update Dockerfile
> 
> \* rename upload\_api to upload\_api\_v3
> 
> \* add tzwhere to requirements.txt
> 
> \* test pyinstaller
> 
> \* fix action
> 
> \* add integration tests on process
> 
> \* fix format to pass CI
> 
> \* fix: post processing
> 
> \* typo
> 
> \* skip if failed to json loading the image description

Then, download.py was deleted during an “add API v4 support” pull request along with the entire readme section on how to download images.

> <https://github.com/mapillary/mapillary_tools/commit/a0716c0a5f9ebce451ec1ef362bacb460c4737f9>
>
> \* feat: add API v4 support
> 
> \* do not require MAPSettingsUserKey
> 
> \* fix mime
> …
> 
> \* add back MAPSettingsUserKey as required
> 
> \* sort images by captured\_at
> 
> \* refactor
> 
> \* v4 login support
> 
> \* handle null cluster id
> 
> \* fix config path
> 
> \* fix types
> 
> \* fix path in windows
> 
> \* fix the vertical path in windows
> 
> \* read captured\_at from mapillary\_image\_description.json instead of EXIF
> 
> \* refactor logins
> 
> \* refactor login again
> 
> \* default api version to v4
> 
> \* delete send\_videos\_for\_processing
> 
> \* delete download commands
> 
> \* bump version to 0.7
> 
> \* update README
> 
> \* remove master key
> 
> \* format
> 
> \* update the endpoints

Both of these were snuck into squashed commits in pull requests that have unrelated titles.

Now, the only way to download your images is through non-obvious API calls. In my opinion, this is a case of enshittification by making it harder and harder for users to extract their own CC BY-SA licensed images.

The ignoring of @tykayn’s request may breach the GDPR’s data portability requirements since you must inform a user who makes a request without undue delay and within one month.

Secondly, only being able to access your data by an obscure API endpoint may also breach GDPR’s data portability requirement. I am not a lawyer and this is not legally actionable.

---

<div class="post-metadata">

**Author:** ![MossTown](https://avatars.discourse-cdn.com/v4/letter/m/90ced4/32.png) [@MossTown](https://forum.mapillary.com/u/MossTown)\
**Post date:** [April 20, 2024, 4:37am UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/6 "2024-04-20T04:37:32Z")

</div>

I am trying to download all of my images with the following query:  
`https://graph.mapillary.com/<image_id>?access_token=<access_token>&fields=thumb_original_url,creator&creator-username=<username>`.

I haven’t yet figured out how to download all of my images in one query or if that is even achievable.

It’s problematic that to obtain my images, I need an access token which is obtained by clicking “Register Application” on [this page](https://www.mapillary.com/dashboard/developers) which won’t let me get an API access token unless I provide a company name and a company website.

Even then, if I am able to get an API token, **my one downloaded image’s metadata has been stripped of the GPS coordinates and creation date** which is important information for archiving our own CC-BY-SA images.

---

<div class="post-metadata">

**Author:** ![Richlv](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/richlv/32/68232_2.png) [@Richlv](https://forum.mapillary.com/u/Richlv)\
**Post date:** [April 20, 2024, 2:43pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/7 "2024-04-20T14:43:30Z")

</div>

Heya Mapillary team, this is giving Mapillary bad name on social media as well.  
What are the plans to fix image downloads (for example, by having a documented API that does not strip crucial info like timestamp, coordinates and heading)?

---

<div class="post-metadata">

**Author:** ![boris](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/boris/32/71767_2.png) [@boris](https://forum.mapillary.com/u/boris)\
**Post date:** [April 24, 2024, 9:30am UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/8 "2024-04-24T09:30:18Z")

</div>

Hi @Richlv, @MossTown could you take a look at the API documentation at [API Documentation](https://www.mapillary.com/developer/api-documentation#image) (Image section).

There is documentation there for how to get the image itself (thumb\_original\_url) as well as all of the metadata (captured\_at, compass\_angle, geometry, and many others). It does require someone to call the API, but the data should all be there. I believe the data is not stored as part of the jpeg itself for performance and searchability, but all the data is available and can be written back to the jpeg if that’s what you would like. Here’s [one example of a script which does this](https://github.com/Stefal/mapillary_download/).

---

<div class="post-metadata">

**Author:** ![MossTown](https://avatars.discourse-cdn.com/v4/letter/m/90ced4/32.png) [@MossTown](https://forum.mapillary.com/u/MossTown)\
**Post date:** [May 3, 2024, 8:51pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/9 "2024-05-03T20:51:05Z")

</div>

I have read the Mapillary API documentation and there is still no documented way to fetch all of my images.

You are proposing that I use a third-party tool to make API calls to fetch my images, and yet there still is no documented way to fetch all of my uploaded sequences, which is needed to fetch all of my images in that tool. [There used to be](https://blog.mapillary.com/product/2017/04/12/how-to-retrieve-mapillary-images-to-use-in-external-tools.html) a well-documented way to fetch all of your sequences but [Mapillary removed it](https://forum.mapillary.com/t/api-v3-is-retiring-on-august-18/5119) when you got rid of the v3 api.

Mapillary is still not providing a means to satisfy the data portability requirement of the GDPR. Telling users to run a script that someone else made on GitHub which is handicapped by Mapillary not documenting how (if it’s even possible) to fetch all of our sequence IDs is not a solution. How do you expect non-technical users to jump through all of these hoops that are convoluted for technical users?

I am disappointed that Mapillary will not even acknowledge this problem and is refusing to comply with the GDPR.

---

<div class="post-metadata">

**Author:** ![MossTown](https://avatars.discourse-cdn.com/v4/letter/m/90ced4/32.png) [@MossTown](https://forum.mapillary.com/u/MossTown)\
**Post date:** [May 3, 2024, 8:56pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/10 "2024-05-03T20:56:47Z")

</div>

Can you honestly say that you are satisfying the right to data portability, as detailed below?

> The right to data portability entitles an individual to:
> 
> ```
> receive a copy of their personal data; and/or
> have their personal data transmitted from one controller to another controller.
> 
> ```
> 
> **Individuals have the right to receive their personal data and store it for further personal use.** This allows the individual to manage and reuse their personal data.

> **Without hindrance** means that you should not put in place any legal, **technical** or financial obstacles which slow down or prevent the transmission of the personal data to the individual, or to another organisation.

[Source](https://ico.org.uk/for-organisations/uk-gdpr-guidance-and-resources/individual-rights/individual-rights/right-to-data-portability/#ib1)

---

<div class="post-metadata">

**Author:** ![filipc](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/filipc/32/1103_2.png) [@filipc](https://forum.mapillary.com/u/filipc)\
**Post date:** [May 4, 2024, 10:27am UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/11 "2024-05-04T10:27:56Z")

</div>

Pictures you supply are no personal data.  
Maybe they are if you figure on them.

---

<div class="post-metadata">

**Author:** ![bob3bob3](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/bob3bob3/32/68393_2.png) [@bob3bob3](https://forum.mapillary.com/u/bob3bob3)\
**Post date:** [May 4, 2024, 6:04pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/12 "2024-05-04T18:04:14Z")

</div>

Now that’s an interesting question @filpic … Do what are essentially “public” views of the world fall into the category of one’s own “personal data”? The captured data is certainly a licensed (CC by 4.0) entity with the required squelching of other persons, but what about the contributor?

[Personal Data - General Data Protection Regulation (GDPR)](https://gdpr-info.eu/issues/personal-data/) says a lot, but I see that it only refers to an identifiable natural person, not corporations, foundations and institutions. Unless by mistake it is unlikely that I have ever uploaded anything that is “me”. A reflection in a shop window might be about all… I am however quite happy that there is nothing identifiable about me that I have uploaded.

I have also kept the many TB’s of my uploads, so apart from ethical reasons, never have to be concerned about portability.

Not a legal view, but I am not concerned about Mapillary storage of my captures.

---

<div class="post-metadata">

**Author:** ![filipc](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/filipc/32/1103_2.png) [@filipc](https://forum.mapillary.com/u/filipc)\
**Post date:** [May 6, 2024, 4:49pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/13 "2024-05-06T16:49:25Z")

</div>

Moreover, most contributors use a false name.

---

<div class="post-metadata">

**Author:** ![micmin1972](https://avatars.discourse-cdn.com/v4/letter/m/59ef9b/32.png) [@micmin1972](https://forum.mapillary.com/u/micmin1972)\
**Post date:** [May 10, 2024, 11:44pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/14 "2024-05-10T23:44:46Z")

</div>

they definitely should add a “export” button somewhere soon to comply to current rules, not offer an unclear api with images and separated gps data

---

<div class="post-metadata">

**Author:** ![MossTown](https://avatars.discourse-cdn.com/v4/letter/m/90ced4/32.png) [@MossTown](https://forum.mapillary.com/u/MossTown)\
**Post date:** [June 27, 2024, 2:14pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/15 "2024-06-27T14:14:38Z")

</div>

Respectfully, it is clear that some of the above comments are Americans making assumptions about GDPR requests based on lack of understanding.

According to the European Union, " Personal data is any information that relates to an **identified or identifiable living individual**. Different pieces of information, which collected together can lead to the identification of a particular person, also constitute personal data.

Personal data that has been de-identified, encrypted or **pseudonymised** but can be used to re-identify a person remains personal data and falls within the scope of the GDPR."

The EU then goes on to specifically state “location data” is included. The images that we upload contain location data AND an image of where we were looking at that time. Even if it has been de-identified or pseudonymised (i.e. a username), it counts as personal data.

> **[What is personal data?](https://commission.europa.eu/law/law-topic/data-protection/reform/what-personal-data_en)**
>
> Personal data is any information that relates to an identified or identifiable living individual. Discover how the General Data Protection Regulation protects them.

---

<div class="post-metadata">

**Author:** ![MossTown](https://avatars.discourse-cdn.com/v4/letter/m/90ced4/32.png) [@MossTown](https://forum.mapillary.com/u/MossTown)\
**Post date:** [June 27, 2024, 2:15pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/16 "2024-06-27T14:15:58Z")

</div>

Still no answer from @boris. Very disappointing.

---

<div class="post-metadata">

**Author:** ![tao](https://avatars.discourse-cdn.com/v4/letter/t/f9ae1b/32.png) [@tao](https://forum.mapillary.com/u/tao)\
**Post date:** [June 29, 2024, 5:30pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/17 "2024-06-29T17:30:04Z")

</div>

Hey @MossTown and all,

We recently added the pagination to our APIs. See [Pagination support for images endpoint](https://forum.mapillary.com/t/pagination-support-for-images-endpoint/8121). All you need is to paginate all your images with `fields=thumb_original_url` and then follow the URLs. If there is anything unclear in the API docs. Let us know.

cc @balys @boris

---

<div class="post-metadata">

**Author:** ![filipc](https://sea1.discourse-cdn.com/flex015/user_avatar/forum.mapillary.com/filipc/32/1103_2.png) [@filipc](https://forum.mapillary.com/u/filipc)\
**Post date:** [July 2, 2024, 6:36pm UTC](https://forum.mapillary.com/t/takeout-feature-to-export-our-data/7928/18 "2024-07-02T18:36:35Z")

</div>

I have watched some Youtube videos on OsInt.  
In that sense, nothing is allowed, no one is safe against those detectives.

What can you find out about me ?
