# Where - day by day location from your photos
This scripts reads EXIF data from your photos and generates CSV file or Pandas dataframe with day by day location in terms of country.
It relies on my package [exif2pandas](https://github.com/Visgean/exif2pandas/). It uses [reverse-geocoder](https://github.com/thampiman/reverse-geocoder) to convert GPS data to country codes. That module uses a csv file with 150k cities and then uses nearest neighbour algorithm to find the position of each gps data point. This sometimes does not work in border regions so if you are seeing bad data the easiest fix is to copy [cities.csv](https://github.com/Visgean/where/blob/main/src/cities.csv) and add your village etc.
In case some of your photos contain bad gps data that show that you have been to countries where you have never been you can use ``ignore_countries`` argument.
## world map
Generated world map with colored regions according to how many days you have spent in the country.
## Pie graph with number of days you spent in a country
## CSV file with your travel list:
```
id,from,to,days,country,country_code
4,2015-11-07,2015-11-09,1,Scotland,GB
5,2015-11-09,2015-12-12,32,Praha,CZ
6,2015-12-12,2015-12-12,0,Budapest,HU
7,2015-12-12,2015-12-12,0,Praha,CZ
8,2015-12-12,2015-12-15,2,Budapest,HU
```
note that the country column is usually wrong - this is because the cities.csv is not consisent with administrative boundaries beyond country_code.
## Year by year histograms
## Raw dataframes:
Finally there is a raw dataframe with exif data per image file:
## Jupyter examples:
See ``example.ipynb`` for example graphs and data frames exported.
## Install:
See PYPI [Python package](https://pypi.org/project/photos-where/).
```
$ pip install photos-where
```
## Use:
```
$ photos_where Dropbox/Photos/2020/
$ ls where
cities-pie.jpg
countries-pie.jpg
intervals.csv
location-by-day.csv
photos.feather
years.jpg
```
Raw data
{
"_id": null,
"home_page": "https://github.com/visgean/where",
"name": "photos-where",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "exif sql",
"author": "Visgean",
"author_email": "visgean@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4f/82/569a6e451d25218d99a9d82f5b8fcab61b649c52cb432ffbb584feb4ffc6/photos_where-2.2.tar.gz",
"platform": null,
"description": "# Where - day by day location from your photos \n\nThis scripts reads EXIF data from your photos and generates CSV file or Pandas dataframe with day by day location in terms of country. \n\nIt relies on my package [exif2pandas](https://github.com/Visgean/exif2pandas/). It uses [reverse-geocoder](https://github.com/thampiman/reverse-geocoder) to convert GPS data to country codes. That module uses a csv file with 150k cities and then uses nearest neighbour algorithm to find the position of each gps data point. This sometimes does not work in border regions so if you are seeing bad data the easiest fix is to copy [cities.csv](https://github.com/Visgean/where/blob/main/src/cities.csv) and add your village etc. \n\nIn case some of your photos contain bad gps data that show that you have been to countries where you have never been you can use ``ignore_countries`` argument. \n\n## world map\n\n\n\nGenerated world map with colored regions according to how many days you have spent in the country.\n\n## Pie graph with number of days you spent in a country\n\n\n\n## CSV file with your travel list:\n\n``` \nid,from,to,days,country,country_code\n4,2015-11-07,2015-11-09,1,Scotland,GB\n5,2015-11-09,2015-12-12,32,Praha,CZ\n6,2015-12-12,2015-12-12,0,Budapest,HU\n7,2015-12-12,2015-12-12,0,Praha,CZ\n8,2015-12-12,2015-12-15,2,Budapest,HU\n\n```\n\nnote that the country column is usually wrong - this is because the cities.csv is not consisent with administrative boundaries beyond country_code. \n\n## Year by year histograms\n\n\n\n## Raw dataframes:\n\nFinally there is a raw dataframe with exif data per image file:\n\n\n\n\n\n## Jupyter examples:\n\nSee ``example.ipynb`` for example graphs and data frames exported.\n\n## Install:\n\nSee PYPI [Python package](https://pypi.org/project/photos-where/). \n\n```\n$ pip install photos-where\n```\n\n## Use:\n\n```\n$ photos_where Dropbox/Photos/2020/\n$ ls where\ncities-pie.jpg \ncountries-pie.jpg\nintervals.csv\nlocation-by-day.csv \nphotos.feather \nyears.jpg\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Analyze exif data",
"version": "2.2",
"project_urls": {
"Homepage": "https://github.com/visgean/where"
},
"split_keywords": [
"exif",
"sql"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4f82569a6e451d25218d99a9d82f5b8fcab61b649c52cb432ffbb584feb4ffc6",
"md5": "9a4c35067d5f31e8747544bfae131a72",
"sha256": "e8cfd64eedb1913d1b76df8a7a2eec903b2a421319fd84f625d796d3c933fd6f"
},
"downloads": -1,
"filename": "photos_where-2.2.tar.gz",
"has_sig": false,
"md5_digest": "9a4c35067d5f31e8747544bfae131a72",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 2644974,
"upload_time": "2024-12-13T14:42:24",
"upload_time_iso_8601": "2024-12-13T14:42:24.097977Z",
"url": "https://files.pythonhosted.org/packages/4f/82/569a6e451d25218d99a9d82f5b8fcab61b649c52cb432ffbb584feb4ffc6/photos_where-2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-13 14:42:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "visgean",
"github_project": "where",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "photos-where"
}
JSON
