Get a local rank grid
get_local_rank_gridRuns one Google Maps search for every point of a square grid centred on a coordinate and reports where the target business ranks at each point, with each point's result count and top listing. Use it to see how Maps visibility changes across an area. Looks 20 results deep per point. Estimated price: $0.04 for 3x3 (9 searches), $0.10 for 5x5 (25 searches). A grid bought with a cid opens on the Local page's Maps visibility tab. Each call may spend up to the workspace's agent spend limit ($2.00 unless changed in Settings) without asking: it holds at most its estimate plus a margin while it runs and is charged what it bought, never more. A call whose maximum is above the limit is refused before anything is bought, with its estimate and maximum: ask the user, then call again with approvedMaxCostUsd set to the amount they approved.
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": {
"projectId": "<projectId>",
"keyword": "<keyword>",
"target": "<target>",
"center": "<center>"
},
"name": "get_local_rank_grid"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zoom | No | Maps zoom for each search. Worked out from spacingKm and the latitude when left out. | |
| center | Yes | Coordinate at the middle of the grid. | |
| device | No | Device to search as. Default mobile. | |
| target | Yes | The business to find. Rows are matched by cid (most reliable), then place_id, then a title that contains the text, ignoring case. name is used only when cid and placeId do not match. Give at least one. | |
| keyword | Yes | Keyword to search on Maps. | |
| gridSize | No | Points per side. 3 runs 9 searches (default), 5 runs 25. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| spacingKm | No | Distance between neighbouring points in km. Default 2. | |
| languageCode | No | Language of the searches. Defaults to the project's. | |
| approvedMaxCostUsd | No | The most, in USD, the user approved for this call after seeing its estimate and maximum. Only needed after a call was refused for costing more than the workspace's agent spend limit; never set it without asking the user. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| grid | Yes | ||
| meta | No | ||
| summary | Yes | ||
| savedResultId | No | ||
| matchedBusiness | Yes |