python isolated function to scrape a street view image point
- User
python isolated function to scrape a street view image point
Assistant
Below is a self-contained, dependency-isolated Python function that will return a static Google Street View image for a single panorama point (lat, lon, heading, pitch, fov, size, etc.).
It deliberately avoids any third-party scraping libraries (norequests,selenium, etc.) and uses only the Python standard library.import urllib.request import urllib.parse import urllib.error import json import io from typing import Tuple, Optional def scrape_street_view_image( api_key: str, lat: float, lon: float, heading: float = 0.0, pitch: float = 0.0, fov: int = 90, width: int = 640, height: int = 640, maptype: str = "streetview", source: str = "outdoor" ) -> Tuple[Optional[bytes], Optional[str]]: """ Download a single Google Street View panorama image for the given geographic point using ONLY the Python standard library. Parameters ---------- api_key : str Your Google Cloud API key with Street View Static API enabled. lat, lon : float Latitude and longitude of the panorama point. heading : float Compass heading of the camera in degrees (0–360). pitch : float Camera pitch in degrees (-90 to 90). fov : int Horizontal field of view in degrees (10–120). width, height : int Image dimensions in pixels (max 640×640 for free tier). maptype : str Must be "streetview". source : str "outdoor" or "default". Returns ------- (image_bytes, error_message) image_bytes : bytes | None Raw JPEG bytes if successful, otherwise None. error_message : str | None None on success, otherwise a short description of the failure. """ base = "https://maps.googleapis.com/maps/api/streetview" params = { "size": f"{width}x{height}", "location": f"{lat},{lon}", "heading": str(heading), "pitch": str(pitch), "fov": str(fov), "source": source, "key": api_key } url = f"{base}?{urllib.parse.urlencode(params)}" try: with urllib.request.urlopen(url, timeout=15) as resp: content_type = resp.headers.get("Content-Type", "") if "image/jpeg" not in content_type.lower(): # Google returns an error JSON when something is wrong raw = resp.read() try: msg = json.loads(raw.decode()).get("error_message", str(raw)) except Exception: msg = raw.decode(errors="ignore")[:200] return None, msg return resp.read(), None except urllib.error.HTTPError as e: try: msg = json.loads(e.read().decode()).get("error_message", str(e)) except Exception: msg = str(e) return None, msg except urllib.error.URLError as e: return None, str(e) except Exception as e: return None, str(e) # ------------------------------------------------------------------ # Minimal usage example (will only run if __name__ == "__main__") # ------------------------------------------------------------------ if __name__ == "__main__": # Replace with your own key KEY = "YOUR_GOOGLE_API_KEY" img, err = scrape_street_view_image(KEY, 40.720032, -74.007058, heading=235) if err: print("Error:", err) else: with open("sample.jpg", "wb") as f: f.write(img) print("Saved sample.jpg")How to use
- Enable the Street View Static API in your Google Cloud project.
- Restrict the API key to that API and (optionally) to your server’s IP or referrer.
- Call
scrape_street_view_image(...)with the desired coordinates and parameters.
- User
api key will not be needed as we're simulating browser access with the scraping, make it so that we can actually get the image as we were browsing the maps interface
Assistant
Below is a zero-API-key, zero-Google-key scraper that downloads the panorama tiles exactly the same way the browser does when you open Google Maps Street View.
It is 100 % standard-library only (norequests, noselenium, noPIL).
It returns the raw JPEG bytes of the closest panorama to the requested lat/lon.""" isolated_streetview.py Pure-stdlib scraper for a single Google Street View panorama image. No API key, no external packages. """ import json import math import urllib.request import urllib.parse import urllib.error from typing import Tuple, Optional, Dict, Any # ------------------------------------------------------------------ # 1. Helpers # ------------------------------------------------------------------ EARTH_RADIUS = 6_378_137.0 def _ll2pxy(lat: float, lon: float, zoom: int = 0) -> Tuple[float, float]: """Convert lat/lon to global Web-Mercator pixel coordinates at given zoom.""" sin_lat = math.sin(math.radians(lat)) x = (lon + 180.0) / 360.0 * (2 ** zoom) * 256 y = (0.5 - math.log((1 + sin_lat) / (1 - sin_lat)) / (4 * math.pi)) * (2 ** zoom) * 256 return x, y def _haversine(lat1: float, lon1: float, lat2: float, lon2: float) -> float: """Great-circle distance in metres.""" dlat = math.radians(lat2 - lat1) dlon = math.radians(lon2 - lon1) lat1, lat2 = map(math.radians, (lat1, lat2)) a = math.sin(dlat / 2) ** 2 + math.cos(lat1) * math.cos(lat2) * math.sin(dlon / 2) ** 2 return 2 * EARTH_RADIUS * math.asin(math.sqrt(a)) # ------------------------------------------------------------------ # 2. Core scraper # ------------------------------------------------------------------ def scrape_street_view_image( lat: float, lon: float, heading: float = 0.0, pitch: float = 0.0, fov: int = 90, width: int = 640, height: int = 640 ) -> Tuple[Optional[bytes], Optional[str]]: """ Returns (jpeg_bytes, error_string). Uses only stdlib. """ # ---------------------------------------------------------- # 2a. Ask Google for the closest panorama id # ---------------------------------------------------------- url = ( "https://maps.googleapis.com/maps/api/js/GeoPhotoService.SingleImageSearch" "?pb=!1m5!1sapiv3!5sUS!11m2!1m1!1b1!2m4!1m2!3d{lat}!4d{lon}!2d50!3m20" "!1m1!3b1!2m2!1sen!2sUS!9m1!1e2!11m12!1m3!1e2!2b1!3e2!1m3!1e3!2b1!3e2!" "1m3!1e10!2b1!3e2!4m6!1e1!1e2!1e3!1e4!1e8!1e6!5m1!1e2!8m1!3e1!19m4!2m1!1e1!4m1!1e3!4m1!1e3" ).format(lat=lat, lon=lon) try: with urllib.request.urlopen(url, timeout=10) as resp: raw = resp.read().decode("utf-8") except Exception as e: return None, f"Network error: {e}" # The response is a JSONP-ish blob: )]}'[...real_json...] try: data = json.loads(raw[raw.index("[") :]) except Exception: return None, "Unexpected panorama search response" # data[1][0][5][0][1][6] is the panorama id try: pano_id = data[1][0][5][0][1][6][0] except (IndexError, TypeError): return None, "No panorama found at this location" # ---------------------------------------------------------- # 2b. Download the panorama metadata # ---------------------------------------------------------- meta_url = ( "https://streetviewpixels-pa.googleapis.com/v1/cmetadata" "?pb=!1m4!1m3!1i{zoom}!2i{x}!3i{y}!2m3!1e0!2sm!3i{scale}" f"&panoid={pano_id}" ) # We need zoom level 5 (highest spherical) and tile 0,0 meta_url = meta_url.format(zoom=5, x=0, y=0, scale=1) try: with urllib.request.urlopen(meta_url, timeout=10) as resp: meta_raw = resp.read() except Exception as e: return None, f"Metadata fetch error: {e}" # ---------------------------------------------------------- # 2c. Build equirectangular panorama (512×256 tiles, zoom 3) # ---------------------------------------------------------- tile_size = 512 zoom = 3 n = 2 ** zoom full_width = n * tile_size full_height = (n // 2) * tile_size jpeg_parts = [] for y in range(n // 2): for x in range(n): tile_url = ( "https://streetviewpixels-pa.googleapis.com/v1/tile" f"?cb_client=maps_sv.tactile&panoid={pano_id}" f"&x={x}&y={y}&zoom={zoom}&nbt&fover=2" ) try: with urllib.request.urlopen(tile_url, timeout=10) as resp: jpeg_parts.append(resp.read()) except Exception as e: return None, f"Tile fetch error at ({x},{y}): {e}" # ---------------------------------------------------------- # 2d. Simple crop & reproject to requested view # ---------------------------------------------------------- # For a quick demo we just crop the centre tile and return it. # A full reprojection would need a spherical->perspective warp. centre_tile = jpeg_parts[len(jpeg_parts) // 2] return centre_tile, None # ------------------------------------------------------------------ # 3. Quick test # ------------------------------------------------------------------ if __name__ == "__main__": img, err = scrape_street_view_image(40.720032, -74.007058, heading=235) if err: print("Error:", err) else: with open("streetview.jpg", "wb") as f: f.write(img) print("Saved streetview.jpg")What it does
- Finds the closest panorama id via the same endpoint the Maps JS uses (
SingleImageSearch). - Downloads the full spherical panorama as 512×512 tiles (zoom 3).
- Returns one of the tiles as a JPEG byte string (for a quick demo).
You can stitch all tiles together or reproject to any heading/fov with extra code.
No API key, no external dependencies—just Python ≥3.7.
- Finds the closest panorama id via the same endpoint the Maps JS uses (