How Iran Live Map compiles conflict reports

From a public report to a pin on the map: sources, scope filters, incident grouping, geolocation, assessment, AI-assisted briefs and corrections.

What we publish

Four things: a live map of reported incidents, a chronological feed of the source reports behind them, a permanent page for every tracked incident, and running live-update pages for each theater. Everything on those surfaces is compiled from public reporting, and nothing is published without a linked source.

Where reports come from

  • International agencies and outlets: Reuters, AP, AFP, BBC, CNN, The New York Times, The Washington Post, Al Jazeera, Al Arabiya and others.
  • Israeli media: The Times of Israel, The Jerusalem Post, Haaretz and Ynet.
  • Iranian media: IRNA, Mehr News, Press TV and Tehran Times.
  • Official channels: U.S. Central Command, the U.S. Department of Defense and the Israel Defense Forces.
  • Public open-source intelligence channels on Telegram and X, used for early reports and footage and labelled by origin.
  • Each source is assigned a perspective (international, U.S., Israeli, Iranian, regional, OSINT or official) so readers can see who is reporting a claim. The sources page lists the outlets and channels currently in the feed.

How a report becomes an incident

Feeds are fetched every 20 minutes. Each new article is checked against the theater it belongs to, so a Ukraine story does not land on the Iran map and a global wire item date-lined Tehran does not get pinned to the Iranian capital. Reports that describe the same event are grouped into one incident with a source count. The grouping is automated and can still split one story into several incidents or, more rarely, join two, which is one reason every incident shows its linked sources.

Geolocation

The place named in a report is matched against a gazetteer of cities, bases, ports, islands and provinces for each theater. Where the gazetteer has no match, a language model proposes coordinates, and those are checked against OpenStreetMap place data with a distance guard before the incident is allowed on the map. Locations that cannot be resolved stay off the map and appear only in the feed. Verified locations are locked so later automated passes cannot move them, and wrong pins reported by readers are fixed by hand.

Assessment

  • Severity, from low to critical, from the category of the event and the language of the reporting.
  • Confidence, from how many independent sources report the event and how specific they are.
  • Flags for disputed claims and for missiles or drones reported intercepted.
  • An escalation level for the last two hours, derived from the frequency and mix of recent military reports.

AI-assisted briefs

Each incident page carries a short brief in three parts: what happened, why it matters and what is unclear. The briefs are drafted by a large language model working only from the reporting linked on that page, and they are labelled as AI-assisted wherever they appear. They are meant to orient a reader, not to replace the sources; they can be wrong, and the linked reporting always takes precedence. The same applies to the daily brief and the analyst chat under the intel tools.

What inclusion means

A report appearing on the map means that a public source made that claim at that time. It is not independent confirmation that the event happened as described. Source count, perspective labels, timestamps and the disputed flag are there so readers can weigh a claim themselves.

Known limitations

  • Source imbalance: some fronts are reported mostly by one side, and Telegram channels report faster than they correct.
  • Time lag: a report can take from minutes to a few hours to be processed, grouped and placed.
  • Automation errors: wrong groupings, wrong pins and misread headlines happen and are corrected when found.
  • Language: reports are compiled in English; original-language sources are linked, not translated in full.

Corrections, removals and archiving

Corrections and takedown requests go through the contact page. A wrong location is re-pinned and locked; a mis-grouped or out-of-scope report is removed; a source that objects to being linked is delinked. Incident pages are kept as a permanent archive so that links keep working and the record of what was reported, and when, stays available. Pages that no longer meet the publication standard are withdrawn from search indexes but not deleted.

Frequently asked questions

How often is the map updated? Source feeds are fetched every 20 minutes and new incidents appear as soon as they are processed and placed. The timestamps on each incident show when it was first reported and last updated.

Why is an incident pinned in the wrong place? Automated geolocation can misread a place name or fall back to a provincial capital. Report the incident from its page and it will be re-pinned by hand and locked against further automated changes.

Are the AI briefs fact-checked? No. They are drafted from the linked reporting on each page, labelled as AI-assisted and reviewed when readers flag problems. The linked sources are the record; the brief is an orientation aid.