streetlevel is a library for downloading panoramas and metadata from street-level imagery services such as Google Street View, Apple Look Around, and several others. It provides a simple abstraction over the internal APIs of the supported services – this means that no API keys are required, but the library may break unexpectedly.
(Nearly) all functions are available as either a sync function using requests or an async function
using aiohttp, requiring a ClientSession.
pip install streetlevelDownloading the closest Google Street View panorama to a specific location, sync:
from streetlevel import streetview
pano = streetview.find_panorama(46.883958, 12.169002)
streetview.download_panorama(pano, f"{pano.id}.jpg")Or async:
from streetlevel import streetview
from aiohttp import ClientSession
async with ClientSession() as session:
pano = await streetview.find_panorama_async(46.883958, 12.169002, session)
await streetview.download_panorama_async(pano, f"{pano.id}.jpg", session)Documentation is available at streetlevel.readthedocs.io.
Services covering multiple countries are on the left; services covering one specific country are on the right.
✔ implemented / available; 🟡 partially implemented; ❌ not implemented; ⚫ not available / not applicable
| Google Street View |
Apple Look Around |
Yandex Panorama |
Bing Streetside |
🇨🇳 Baidu Panorama |
🇰🇷 Kakao Road View |
🇰🇷 Naver Street View |
🇨🇿 Mapy.cz Panorama |
🇮🇸 Já 360 |
||
|---|---|---|---|---|---|---|---|---|---|---|
Finding panoramas How panoramas can be retrieved through the API. |
||||||||||
| Find panoramas around a point | ✔1 | ⚫ | ✔1 | ✔ | ✔1 | ✔ | ✔1 | ✔1 | ✔1 | |
| Find panoramas by map tile or bbox | ✔2 | ✔2 | ⚫ | ✔3 | ⚫ | ⚫ | ⚫ | ⚫ | ⚫ | |
| Get specific panorama by ID | ✔ | ⚫ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
Imagery The type of imagery returned by the service. |
||||||||||
| Panoramas | ✔ | ✔4 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
| Depth | ✔5 | ❌ | ⚫ | ⚫ | ❌?10 | ✔ | ✔14 | ⚫ |
⚫ |
|
| Image projection | Equirectangular | ??? | Equirectangular | Cubemap | Equirectangular | Equirectangular | Equirectangular/Cubemap13 | Equirectangular | Cubemap | |
| Image format | JPEG | HEIC | JPEG | JPEG | JPEG | JPEG | JPEG | JPEG | JPEG | |
Available metadata Metadata returned by the API of the service alongside ID and location. |
||||||||||
| Capture date | ✔6 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔9 | |
| Heading, pitch, roll | ✔ | ✔ | ✔7 | ✔ | ✔ | ✔7 | ✔11 | ✔ | ✔7 | |
| Elevation | ✔ | ✔ | ⚫ | ✔ | ✔ | ⚫ | ⚫12 | ✔ | ⚫ | |
| Nearby / linked panoramas | ✔ | ⚫ | ✔ | ✔8 | ✔ | ✔ | ✔ | ✔ | ✔ | |
| Historical panoramas | ✔ | ⚫ | ✔ | ⚫ | ✔ | ✔ | ✔ | ✔ | ⚫ | |
| Address | ✔ | ⚫ | ✔ | ⚫ | ⚫ | ✔ | ✔ | ⚫ | ✔ | |
| PoIs | ✔ | ❌ | ✔ | ⚫ | ⚫ | ❌ | ❌ | ⚫ | ⚫ | |
| Creator | ✔ | ⚫ | ✔ | ⚫ | ✔ | ⚫ | ⚫ | ✔ | ⚫ | |
1: Returns closest only
2: Tile, z=17
3: Bounding box
4: Unstitched
5: Appears to be a synthetic depth map created from elevation data and building footprints
6: Month and year only for official coverage, full date for inofficial coverage
7: Only heading; pitch/roll do not appear to be available
8: Previous and next image in sequence
9: Month and year only
10: There is a has_depth field in the raw metadata, but I've yet to find a panorama that actually has depth
11: Pitch/roll are only available for the new 3D imagery
12: Camera altitude is available, however
13: 3D imagery panos have both an equirectangular and a cubemap version; everything else is only available as cubemap
14: Non-3D imagery appears to use a synthetic depthmap created from elevation data and building footprints
https://streetlevel.readthedocs.io/en/master/streetlevel.baidu.html
This open-source code is provided solely for scientific research. It must not be used for commercial purposes or for any illegal or unethical activity. Please comply with all applicable laws—any misuse is the sole responsibility of the user and is unrelated to the author.