Google Maps Area Scanner

Scan a bounded area for public Google Maps places. With explicit center coordinates, the Actor creates a deterministic center-first circular grid of overlapping Maps searches, filters source coordinates to the requested radius, and deduplicates places globally across every query and scan cell. With a location name only, it performs one location-qualified Maps search per query.

Input

{
  "query": "coffee shops",
  "latitude": 40.758,
  "longitude": -73.9855,
  "radiusMeters": 2000,
  "cellSpacingMeters": 1500,
  "maxScanPoints": 9,
  "maxItems": 50,
  "maxItemsPerScan": 10,
  "minRating": 4,
  "closedPlaces": "skipClosed",
  "useApifyProxy": false
}

Use queries for a batch. The product of queries and scan points is capped at 100 requests. maxItems is global; writes are serialized even when multiple cells run concurrently. Legacy query/location/coordinate/radius/limit/filter/proxy aliases remain accepted.

Output

Each strict dataset row includes stable Maps identity, exact Maps URL, public business fields, the originating query and scan point, requested center/radius/cell/zoom, global and per-cell ranks, place distance from the requested center, source, extraction method, and timestamp. Coordinate mode excludes source-backed places outside the requested radius.

Structured Maps responses are preferred and merged with a visible-card DOM fallback. Response listeners are scoped and removed, response reads are status/content-type/size/timeout bounded, and records never contain cookies, authorization material, raw responses, internal data blobs, proxy URLs, debug snapshots, geocoding credentials, or fabricated fields. Explicit no-results completes with an empty dataset; access challenges and selector/payload drift fail closed.

Responsible use

The Actor accesses public Google Maps data only. It does not bypass authentication, CAPTCHA, account restrictions, or other access controls. Use modest scan sizes and comply with applicable terms and laws.