Cette page n’est pas encore traduite. Vous lisez la version anglaise.

Embed MapDove on your website

Publish a live, read-only MapDove chart or map on your own website with a copy-paste iframe: visit trends, busiest hours, trade areas, market snapshots and brand share.

Landlords, brokers, cities and economic development offices can show live MapDove data on their own websites: a place’s visit trend on a leasing page, a downtown market snapshot on an economic development site, or a brand’s share of its category in a city. Each widget is a small, read-only page that you add with a copy-paste <iframe>. It updates with the data and needs no code on your side.

Website embeds are included on Pro (3 embeds, 10,000 views a month), Business (25 embeds, 100,000 views) and Enterprise (unlimited). See Plans and limits.

Widget types

Widget Where to create it What it shows
Visit trend a place page modeled visits per week (last 4–52 weeks) or month (last 3–12 months), the total and the change against the period before
Busiest hours a place page a day-of-week × hour heatmap of modeled visits, with the busiest time
Trade area map a place page the hexagons where 85% of the place’s modeled visitors come from, with population, area and median distance
Market snapshot the Market page a city’s (or one category’s) total visits and change, its top places, and each category’s share of visits
Brand share of category a brand page the brand’s share of its category’s modeled visits in a city, its change in points, its rank and the leading brands

Create a widget

  1. Open the place, the Market page or the brand you want to show and click Embed. Only workspace owners and admins can create embeds.
  2. Pick the widget type and its options (period, city, category, number of rows).
  3. Choose a theme (Auto follows each visitor’s light or dark setting, or pick Light, Dark, Midnight or Sand) and the language (any of MapDove’s ten; Arabic is laid out right to left).
  4. Under Allowed websites, list every site the widget may appear on, one per line: example.com, www.example.com, or *.example.com for all subdomains. Wildcards on shared domains such as *.github.io or *.co.uk aren’t accepted: list your own site instead. Use http:// only for a site without HTTPS.
  5. Check the live preview, then click Create embed and copy the embed code.

Paste the code into your page where the widget should appear:

<iframe src="https://api.mapdove.com/embed/9f0c…" title="Downtown visits · MapDove" width="100%" height="380"
  style="border:0;max-width:720px" loading="lazy" referrerpolicy="strict-origin-when-cross-origin"
  sandbox="allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox"></iframe>

Change height if your layout needs it. Most site builders (WordPress, Webflow, Squarespace, Wix) accept the code in an HTML or embed block.

Manage widgets

Settings → Website embeds lists your workspace’s widgets with their views this month and in total. From there you can copy the code again, edit a widget (its type options, theme, language and allowed websites; the embed code stays the same), pause and resume it, or delete it. A deleted widget stops working everywhere at once.

Where a widget can appear

A widget only loads inside pages on its allowed websites. MapDove enforces this in the browser with a per-widget Content-Security-Policy: frame-ancestors header, so a site that copies your embed code sees nothing. On any other site the frame stays blank or says the chart can’t be shown there. You can also open the widget’s own address directly, which is handy for checking it.

What visitors see

  • Live figures from MapDove, in the theme and language you chose, with a chart title and a hidden data table for screen readers.
  • The footer “Modeled estimates · © OpenStreetMap contributors · MapDove” with a link to mapdove.com. Visit figures are modeled estimates, not measurements, and place data comes from OpenStreetMap, so this attribution is required and can’t be removed.
  • When a widget can’t be shown (it is paused, the monthly view allowance is used up, or MapDove is under maintenance), a short “temporarily unavailable” message instead of an error.

Views and limits

Each time a visitor’s browser loads a widget’s data counts as one view; reloads by the same visitor within 30 minutes count once. Previews in MapDove don’t count. Views are totaled per workspace each calendar month (UTC) and shown in Settings → Billing. Over the allowance, widgets show “temporarily unavailable” until the next month or an upgrade; nothing is deleted. Each widget is also rate-limited per visitor, so one misbehaving page can’t use up your allowance.

If you move to a plan with fewer embeds, your oldest widgets keep working up to the new limit; the others show “temporarily unavailable” until you delete some or upgrade.

Privacy and security

  • No cookies and no tracking. Widgets set no cookies, store nothing on visitors’ devices, and load no analytics, session recording or other third-party code. Adding a widget doesn’t add trackers to your site.
  • No personal data. MapDove counts views per widget without storing visitors’ IP addresses or any identifier. See the Cookie Policy and Privacy Policy.
  • Only that widget’s data. A widget can read exactly what it shows, nothing else from your workspace: no other places, projects, members or API keys.
  • Sandboxed. The embed code runs the widget in a sandboxed frame, separate from your page.

For developers

The widget page is GET https://api.mapdove.com/embed/<id> and its data GET /embed/<id>/data on the same origin. Both are documented in the API contract (“Embeddable widgets”), along with the endpoints the app uses to create and manage widgets (/api/v1/embeds). Widgets are managed from a signed-in session; API keys can’t create them.