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.

The complete input contract, including all current fields and compatibility aliases, is in .actor/input_schema.json.

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. When the result card displays them, rows also include its short description, public review excerpt, sponsored label, accessibility features, and service options. Coordinate mode excludes source-backed places outside the requested radius. Optional fields are omitted when Google does not show or return them.

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.

The complete dataset schema, with field types and requiredness, is in .actor/dataset_schema.json.

Live card field excerpt

Chrome inspection of the public coffee shops Times Square, New York results showed the For Five Coffee Times Square card with the following source fields. This is a page-derived field excerpt, not a claimed Actor dataset row; generated ranks and timestamps are intentionally omitted because no Actor run was made.

{
  "id": "ChIJq4PkgFVYwokRqNezQUFocOQ",
  "placeId": "ChIJq4PkgFVYwokRqNezQUFocOQ",
  "cid": "0x89c2585580e483ab:0xe470684141b3d7a8",
  "name": "For Five Coffee Times Square",
  "url": "https://www.google.com/maps/place/For+Five+Coffee+Times+Square/data=!4m7!3m6!1s0x89c2585580e483ab:0xe470684141b3d7a8!8m2!3d40.7579144!4d-73.9831988!16s%2Fg%2F11c1xjnyxs!19sChIJq4PkgFVYwokRqNezQUFocOQ",
  "category": "Coffee shop",
  "address": "117 W 46th St",
  "latitude": 40.7579144,
  "longitude": -73.9831988,
  "rating": 4.0,
  "reviewCount": 559,
  "priceLevel": "$1 to $20",
  "description": "Craft coffee shop with breakfast and lunch",
  "status": "Open · Closes 7 PM",
  "openNow": true,
  "isAdvertisement": false,
  "accessibilityFeatures": ["Wheelchair accessible entrance"],
  "reviewSnippet": "Quiet clean staff friendly Good coffee and Hot chocolate",
  "query": "coffee shops",
  "queryIndex": 1,
  "scanPointIndex": 1,
  "requestedLocation": "Times Square, New York",
  "requestedRadiusMeters": 2000,
  "cellSpacingMeters": 1500,
  "zoom": 14,
  "searchUrl": "https://www.google.com/maps/search/coffee%20shops%20Times%20Square%2C%20New%20York?hl=en&gl=us",
  "language": "en",
  "requestedCountry": "US",
  "source": "Google Maps"
}

The page exposed the place identity, card details, and search context above. A completed Actor row additionally has per-run extraction provenance and a scrape timestamp; those values are created by an Actor run and are not represented by this excerpt.

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.