Focus Mode

Focus Mode isolates a single country on the rendered map. Everything outside the target country is masked white. Neighboring countries are shown with faint borders for geographic context.

💡

Focus Mode only applies to image responses (format: "png" or "jpeg"). JSON responses return the same location data regardless of Focus Mode parameters.

Parameters

Parameter	Type	Default	Description
`focus_country`	string	—	ISO 3166-1 alpha-2 code (e.g. `"US"`, `"DE"`, `"JP"`)
`focus_region`	string	—	US only: `"conus"`, `"alaska"`, or `"hawaii"`
`show_neighbors`	boolean	`true`	Show faint gray neighboring countries

Example request

{
  "brand": "Starbucks",
  "format": "png",
  "focus_country": "US",
  "focus_region": "conus",
  "show_neighbors": true,
  "style": "slate"
}

US regions

When focus_country is "US", the focus_region parameter lets you isolate a specific area:

Region	Description
`conus`	Continental US (lower 48 states)
`alaska`	Alaska only
`hawaii`	Hawaii only

If focus_region is omitted with focus_country: "US", the full US including Alaska and Hawaii is shown.

Neighbor display

show_neighbors defaults to true, which renders surrounding countries with faint gray fills and light borders. This provides geographic context without competing visually with the target country.

Set to false for a completely clean isolated view where only the target country shape appears.

Combining with other parameters

Focus Mode works with all other map rendering parameters:

{
  "brand": "McDonald's",
  "format": "png",
  "country": "DE",
  "focus_country": "DE",
  "style": "dark",
  "marker_color": "#DA291C",
  "width": 1920,
  "height": 1080,
  "include_legend": true
}

This renders a 1920×1080 dark-themed map of McDonald's locations in Germany, isolated with Focus Mode, with red markers and a legend overlay.

Image Response Available Brands