Skip to main content
Glama

Maps Census

Create a Maps Census report

create_report

Create a Maps Census report: counts of Google Maps places for business types in a zone, with optional filters, rows split by one dimension and a measure in columns. Returns the report URL at once; call get_report for the figures. Each row costs one count, plus one per column (two for a share).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "country_code": "<country_code>"
    },
    "name": "create_report"
  }
}

Input Schema

NameRequiredDescriptionDefault
cityNoCity name.
titleNoReport title, 120 characters at most. Default: built from the types and the zone.
typesNoBusiness types: slugs ("dentist") or names in the report language ("Dentiste"). Omit for all businesses.
admin1NoRegion or state, by name ("Île-de-France", "California") or code ("11", "CA").
admin2NoDepartment or county, by name or code. In the United States, give admin1 too.
chartsNoCharts on the report page, above its table. Default: bars.
localeNoLanguage of the report, its labels and its URL. Default: en.
columnsNoWhat the columns show: indicator (the share of each row with each indicator), type, rating, reviews or phone (a cross table; phone not in US, CA, DO, PR, MX, CL, DK, where landline and mobile numbers cannot be told apart), none (the count only). Default: indicator, or none when breakdown is indicator.
measureNoFor a cross table: count (places per cell) or share (the share of each cell with share_indicator). Default: count.
breakdownNoHow the rows split the set: none (one row), type (one row per type, two types at least), location (one row per zone, see location_level), rating, reviews or phone (one row per band; phone not in US, CA, DO, PR, MX, CL, DK, where landline and mobile numbers cannot be told apart), indicator (one row per indicator). Default: none.
indicatorsNoIndicators of indicator rows or columns, 12 at most. Default: website, email, phone, Facebook, Instagram, LinkedIn, less the filters given.
full_reportNotrue only when the user asks for a written report, a PDF or a page to share: the report then gets a written analysis and a PDF, a minute or two after the counts. Leave it false when the user only wants figures. Default: false.
country_codeYesISO 3166-1 alpha-2 country code, e.g. "FR" or "US".
gmap_has_phoneNotrue: only places with a phone number; false: only places without one.
gmap_is_closedNotrue: only places marked permanently closed; false: only places not marked closed.
location_levelNoZone level of the rows when breakdown is location. Default: the level just under the zone.
gmap_phone_typeNoOnly places with this phone type; not in US, CA, DO, PR, MX, CL, DK, where landline and mobile numbers cannot be told apart.
share_indicatorNoThe indicator a share measure counts.
gmap_has_websiteNotrue: only places with a website; false: only places without one.
gmap_is_main_typeNotrue: only places whose main type is one of the types; false: only places where it is a secondary type.
website_has_emailsNotrue: only places whose website shows an email; false: only places whose website shows none.
website_has_tiktokNoSame, for a TikTok link.
website_has_twitterNoSame, for an X (Twitter) link.
website_has_youtubeNoSame, for a YouTube link.
website_has_facebookNoSame, for a Facebook link.
website_has_linkedinNoSame, for a LinkedIn link.
website_has_ad_pixelsNoSame, for ad pixels.
website_has_instagramNoSame, for an Instagram link.
gmap_first_seen_at_gteNoOnly places first indexed on or after this date, YYYY-MM-DD.
gmap_first_seen_at_lteNoOnly places first indexed on or before this date, YYYY-MM-DD.
gmap_reviews_count_gteNoMinimum review count: 0, 50, 200, 500 or 501 (more than 500).
gmap_reviews_count_lteNoMaximum review count: 0, 50, 200, 500 or 501 (more than 500).
gmap_reviews_rating_gteNoMinimum rating, 0 to 5.
gmap_reviews_rating_lteNoMaximum rating, 0 to 5.
website_has_contact_pagesNoSame, for a contact page.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources