{"id":13584885,"url":"https://github.com/robolyst/streetview","last_synced_at":"2025-12-14T06:02:27.797Z","repository":{"id":53892747,"uuid":"66042307","full_name":"robolyst/streetview","owner":"robolyst","description":"Python package for retrieving current and historical photos from Google Street View","archived":false,"fork":false,"pushed_at":"2024-04-16T02:37:05.000Z","size":1527,"stargazers_count":311,"open_issues_count":7,"forks_count":99,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-05-19T23:36:51.875Z","etag":null,"topics":["google-streetview","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robolyst.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-19T01:23:20.000Z","updated_at":"2024-05-17T09:07:18.000Z","dependencies_parsed_at":"2023-02-10T01:31:10.886Z","dependency_job_id":"9d0f17ea-f3de-4630-9e46-2a84ddf5ab21","html_url":"https://github.com/robolyst/streetview","commit_stats":{"total_commits":46,"total_committers":9,"mean_commits":5.111111111111111,"dds":"0.32608695652173914","last_synced_commit":"5b4947c9d386b76d023a89822847c7522663f4bc"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robolyst%2Fstreetview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robolyst%2Fstreetview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robolyst%2Fstreetview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robolyst%2Fstreetview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robolyst","download_url":"https://codeload.github.com/robolyst/streetview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223273160,"owners_count":17117752,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google-streetview","python"],"created_at":"2024-08-01T15:04:35.103Z","updated_at":"2025-12-14T06:02:27.788Z","avatar_url":"https://github.com/robolyst.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# streetview\n\n[![PyPI version](https://badge.fury.io/py/streetview.svg)](https://badge.fury.io/py/streetview)\n[![PyPI Downloads](https://static.pepy.tech/badge/streetview)](https://pepy.tech/projects/streetview)\n\nThis is a light module for downloading photos from Google street view. The\nfunctions allow you to retrieve current and **old** photos. Google does have an\nAPI for accessing Street View. However, it does not allow you to access old\nphotos. Their javascript API allows you to download segments of current photos.\nThis API also allows you to download each full panorama as you see it on Google\nStreet View.\n\n*Please note, Google does not maintain the access points used by this API for\npublic use. Therefore, this hack may break if Google makes changes to how\nStreet View works.*\n\n# Install\n\nInstall from pip with:\n\n\tpip install streetview\n\n# Quick start\n\n## Search for Panoramas\n\nThe photos on Google street view are panoramas. Each parnorama has its own\nunique ID. Retrieving photos is a two step process. First, you must translate GPS\ncoordinates into panorama IDs. The following code retrieves a list of\nthe closest panoramas:\n\n```python\nfrom streetview import search_panoramas\n\npanos = search_panoramas(lat=41.8982208, lon=12.4764804)\nfirst = panos[0]\n\nprint(first)\n# pano_id='_R1mwpMkiqa2p0zp48EBJg' lat=41.89820676786453 lon=12.47644220919742 heading=0.8815613985061646 pitch=89.001953125 roll=0.1744659692049026 date='2019-08'\n```\n\n## Get Metadata\n\nNot all panoramas will have a `date` field in the search results. You can fetch a date for any valid panorama from the metadata api:\n\n```python\nfrom streetview import get_panorama_meta\n\nmeta = get_panorama_meta(pano_id='_R1mwpMkiqa2p0zp48EBJg', api_key=GOOGLE_MAPS_API_KEY)\n\nprint(meta)\n# date='2019-08' location=Location(lat=41.89820659475458, lng=12.47644649615282) pano_id='_R1mwpMkiqa2p0zp48EBJg'\n```\n## Download streetview image\n\nYou can then use the panorama ids to download streetview images:\n```python\nfrom streetview import get_streetview\n\nimage = get_streetview(\n    pano_id=\"z80QZ1_QgCbYwj7RrmlS0Q\",\n    api_key=GOOGLE_MAPS_API_KEY,\n)\n\nimage.save(\"image.jpg\", \"jpeg\")\n```\n\n## Download panorama\n\nYou can download a full panorama like this:\n\n```python\nfrom streetview import get_panorama\n\nimage = get_panorama(pano_id=\"z80QZ1_QgCbYwj7RrmlS0Q\")\n\nimage.save(\"image.jpg\", \"jpeg\")\n```\n\nTo download the panorama in an asynchronous context:\n\n```python\nfrom streetview import get_panorama_async\n\nimage = await get_panorama_async(pano_id=\"z80QZ1_QgCbYwj7RrmlS0Q\")\n\nimage.save(\"image.jpg\", \"jpeg\")\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobolyst%2Fstreetview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobolyst%2Fstreetview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobolyst%2Fstreetview/lists"}