How to map damage on OpenStreetMap?

Hello everyone,

With this great work done in Mayotte by OSM France and especially @SeverinGeo I was wondering how to best tag damage on OpenStreetMap. There are many contradicting informations on the OSM wiki and it would be great to somehow agree a bit better how we do this on OpenStreetMap.

It seems like lots of damage mapping currently on OpenStreetMap is using a lifecycle prefix, especially the destroyed prefix. But in my eyes this does not allow for detailed enough damage mapping, a building is not necessarily complete destroyed and uninhabited.

There is as well this wiki page describing damage mapping. What explains what was used in previous damage mapping projects - which is different than the usage of the lifecycle prefixes.

What was used in Mayotte and some other previous damage mapping projects was the BAR methodology. Which seem to be developed for wind disaster damage assessments. So can this categorization as well be used in different disasters such as an earthquake?

For Cyclone Chido (which is a wind disaster) the BAR methodology was used and the following tags were used:

  • building=yes
  • damage:Chido=none OR minimal OR significant OR complete → according BAR methodology
  • damage:Chido:assessement=2023-03 → where the value is the date of the imagery used or damage assessment done on the ground
  • damage:Chido:event=TC-2024-000225-COM → where the value is the GLIDE number of the disaster, to be found on this reference site.
  • source:damage:Chido=CNES / Airbus → where the value is that of the organization that created the imagery or did the survey

And as such I think this makes perfect sense in this situation, but I was wondering how than to adapt it for more conflict situations such as Khartoum in Sudan at the moment. Should we than best leave out the tags of such an event because it is not related to one short event but rather to an ongoing crises?

Look forward to hear your insights!

Best, Jorieke

My first question would be what is your purpose for mapping the damage in OSM?

If the damage is damage:Chiro=minimal, what is the use case for including it in OSM?

Is it because there are no better databases where this data can be collected?

If there is a tag source:damage:Chido=CNES / Airbus, is this basically importing data from some other database into OSM?

1 Like

Hi Jarek, thanks for your response!

There are indeed already a lot of initiatives for damage mapping, but there is to my knowledge no real coordinated effort or global database existing at the moment. Also not all the damage databases that are around are of great quality and could use human eyes (on the ground) to verify if it is of good quality. So I think it is especially on these two points where OpenStreetMap brings value; having all data in one global database that is being used already by a lot of first responders and humanitarian organisations + the aspect of human validation and knowledge of local contributors.

Why a more detailed classification? Because it is of importance to understand damage more in detail for example for first responders. Has a neighbourhood or village only buildings that are minimally damaged - than they will not need to go there, if there is a neighbourhood with most of the buildings severely damaged, it is important to go there! As well for other activities more detailed information is useful: based on population numbers we can approximately understand how many people are living in severely damaged buildings and plan for distributions for food and non-food items, being aware of what roads are damaged can ambulances still drive over it or not, as well as for advocacy purpose it is important to understand the impact of damage such as in this example.

However I think I’m not necessarily saying that always we should do full damage assessments on OpenStreetMap, my question rather came up because people are currently mapping damage on OpenStreetMap - which is at the moment rather difficult to use because of all the different tags that are used.

I think in the example of Chido - the tag source:damage:Chido=CNES / Airbus , refers to a satellite image. This was not an import of data from another database into OSM. This tag could be for example as well source:damage:Chido=Bing Imagery or source:damage:Chido=survey

2 Likes

Certainly, but I’m not understanding how it translates to tagging damage as minimal or none. To find areas that were most damaged, look for severe damage tags and compare to overall number of buildings. Or is this intended as a tag to indicate that the building/area was assessed and no damage was seen (as opposed to not knowing if a building was not yet assessed)? If so, I would suggest doing away with distinction between minimal or none.

Also complete damage should probably result in building being tagged demolished:building=* rather than building=*.

A follow-up question is whether these event-specific damage tags are intended to be updated as the damage is repaired, when will they be updated, and who will do it? Having a solid plan for this will help avoid a perception that OSM is being used as a dumping ground for data out of convenience.

I think it’d be a lot better to have all of this information in a separate database and to use some sort of ref tag (possibly ref:Chido) on OSM buildings to link them to that database. That would allow you to keep razed/destroyed buildings in your own dataset (if you so desire) even after they’ve been removed from OSM. It would also allow you to use a different license for that database (if you want that).

1 Like

This classification was build on this BAR methodology that uses: none - minimal - significant - complete

I think indeed that the none it is as you said; “a tag to indicate that the building/area was assessed and no damage was seen (as opposed to not knowing if a building was not yet assessed).”
I think I don’t agree in doing away the distinction between minimal and none because with minimal there is actually damage.

For complete, what about using destroyed:building=* ? I the wiki describes demolished:building=* rather as intentional removal which damage not necessarily is. In a lot of cases people will reconstruct it over time.

1 Like

Hi @Friendly_Ghost,
Thanks for sharing your thoughts - much appreciated!
I think I wrote above my opinion on why I think this data has its place in OpenStreetMap, but I guess if most of the people here disagree with me, this should as well be clearly documented on the wiki. So I’m curious to hear from more of you on this point…

Hi @Friendly_Ghost ,
I was just rereading your message and I think I only now fully understood what you meant. Apologies.
I think it should indeed not be the goal to keep the non-existing buildings on OSM. So yes I think you are absolutely right in that. I agree that if a building is not existing anymore, it should not stay on OSM - and it could indeed further exist in another database.
However during eg. an earthquake a building does not just disapear, it is rather damaged and will be rebuild in a lot of situations - in which case it probably should stay on OSM - or in other situations the leftovers will be removed and it should than at that point be removed from OSM as well.

3 Likes

I am late jumping into this thread I had missed and just a quick reply as I am currently on a short trip with only my phone.
I tried to explain the use of (part of) the BAR methodology and the tagging I adopted in both the blog post and the OSM wiki page mentioned by @Jorieke_V . It does not interfere with the usual OSM tags, e.g. building. I am not convinced by the use of damage:building or destroyed:building for disasters, because they are not event-specific and need to be updated, which is not the case with the ones I adopted: they can remain and another future disaster can also be documented this way for the same buildings (of course if they are only damaged and not destroyed).
As explained by Jorieke, there is no existing database alternative to store this kind of data, and actually OSM is pretty good for the purpose IMO. Flexible and collaborative, but even regarding the long-term perspective someone mentioned. Keep in mind that OSM keeps track of the entire history of edits. It is not yet super easy to manage (even I think this might change soon with the new OSM format files and tools like those provided by HeiGIT), but with a bit of mastery of OSM history files you can process this in PostgreSQL.
Putting a tag for none and minimal is important IMO to avoid any doubt regarding the structure is undamaged or just not evaluated (this is an issue with the Copernicus EMSR data I mention, IMO). Also, minimal is the name of the class, but if you look at the BAR definition and the example provided, the structure has lost part of its roof, which can even make it unusable.
Regarding the completely damaged or destroyed buildings, yes, of course they will likely be replaced in the future, but as of now, in the most recent imagery available for OSM, they have not disappeared, but stand as piles of rubble, and they may remain for quite some time. In Haiti, destroyed buildings stood for years after the 2010 earthquake. We could use destroyed:building in addition of the damage tag, easy to add though.

1 Like

what is the longer term plan here?

Because things like damage:Chido=none definitely should not stay forever in OSM

this tags sounds like CNES / Airbus caused this damage

3 Likes

Thanks a lot for your comments @Mateusz_Konieczny !

I leave it to @SeverinGeo to respond about their plans, but I’m interested to hear why it should not stay in OSM in your opinion?

I agree, maybe the tag does not need the reference to Chido in it? Just source:damage=CNES/Airbus ?

Verifiability - OpenStreetMap Wiki and also OSM is not a place to map historic data

For example, mapping whether given building was damaged during WW II or WW I or cyclone 40 years ago or earthquake 5 years ago or flood 150 years ago seems clearly out of scope for OSM for me.

That is rather for OpenHistoricalMap - OpenStreetMap Wiki

Very recent one seems fine, like was:building=yes is OK until aerials are updated.

2 Likes

Thanks everyone already for all your inputs. What do you think of the following proposal for mapping damaged buildings on OSM:

building=*
damage=minimal OR damage=significant OR damage=complete
source:damage=* (which will be most often the imagery used or survey)
source:damage:date=YYYY-MM-DD

If the damage is because of a specific event the tag damage:nameofevent:event=GLIDE numbercould be added.

When a building is than removed fully - when there is even no rubble anymore to see on the ground - I would propose for these damage tags to be removed and the building can than be retagged with the destroyed:building=* or just deleted from OSM. Of course if the damage is repaired and the building being reconstructed, the damage tags should also disappear from OSM.

What do you think?

1 Like

That is a new one for me!
What would be the difference between destroyed:building=yes and was:building=yes ?

And there is actually as well sometimes ruins that people sometimes use…

little to none, this is nearly the same thing (was: may be more fitting for objects that were moved/temporarily dismantled etc, which may happen even with buildings)

ruins: is more fitting if there are some still present remains, was: and destroyed: includes cases where no remains whatsoever remain

1 Like

I have just come across this forum thread that might be relevant. I’m linking it here for reference at the moment, I have not fully read through it to completely understand it.

Do we have building for existing ruins of a building? - General talk / Tagging general discussion - OpenStreetMap Community Forum

And another wiki page that might be relevant: Key:building:condition - OpenStreetMap Wiki

It becomes slightly overwhelming to me…

Based on this discussion, glad to say that same approach as outlined by @Jorieke_V & @SeverinGeo is being used for this latest Nigeria Mokwa flood response: Nigeria Floods Mokwa, 2025

1 Like

Please note, in particular @SeverinGeo and @Jorieke_V that disucssion on damage mapping has continued here

1 Like

@Jorieke_V @SColchester Since the new thread is about flood damage and not wind damage, I will post my (long) answer here because it does not apply to flood damage.

Keep the damage tag?

The issue of whether to keep the damage tag may appear as a short-term vs. long-term approach regarding a tag that informs about a past event. Those in favor of the short-term approach consider the damage tag a “historical” tag that should not remain in OSM but be tolerated for a few months following the disaster. However, this historical feature is not only related to a past event.

First, “historical” does not mean that it is unrelated to the current situation. There are historical tags in OSM that are commonly used and accepted. The most common example is start_date=*, a de facto key that is difficult to verify on site and has occurred more than 17 million times in OSM. It is certainly very interesting information for the present. A building constructed ten years ago likely has different characteristics than a building constructed fifty years ago.

Some people seem to consider damage as something temporary by nature. If I may quote from past discussions in the forum: “Of course, if the damage is repaired, the damage tags should also disappear from OSM.” However, I disagree with this opinion because the repairs may not restore the building. From my discussions with architects based in Mayotte, I learned that damaged buildings may never be the same and that being hit by Cyclone Chido will become an intrinsic feature of them. Even buildings that appear unaffected are expected to encounter problems in the future due to Cyclone Chido and the frequent use of poor construction techniques. This is also typically the case for buildings with concrete roofs that serve as basements for future floors. These buildings seem unaffected, but they often have cracks that are not visible in satellite imagery.

Consequently, it makes sense to keep information about such dramatic disasters whose damages will leave scars for decades. This may not be the case for every disaster, nor may it be appreciated by those responsible for damage evaluations.

Inform about the event name

Such a cyclone has not affected Mayotte for decades, and we hope it will not happen again for at least the same amount of time. However, it may occur more frequently in the future due to climate change. Therefore, I would not use just the simple damage key as proposed, but rather keep the damage:[disaster_name]=* approach, because it could cause confusion if a second major disaster occurs.

Cover all cases

I do not understand why the “no damage” case should be excluded. The international ISO 19011:2018 standard for auditing processes requires marking non‑applicable items as “N/A” and recording “None” or “No observation” when an item yields no finding. I mention this not to say that we should necessarily follow ISO standards, but it is widely accepted that leaving uninformed cases is confusing. I experienced this when I compared the results of the BAR-inspired assessment in OSM with the Copernicus EMSR assessment.

The current damage tagging I implemented in the presets currently misses at least one case: when evaluation is not possible based on the imagery. We could specify the reason: cloud coverage or hidden by a taller building. In Mayotte, the Not applicable (N/A) case would be used at least for buildings in ruins. There may be other cases, in Mayotte or in different contexts.**

“No roof” is also interesting information, but there is no official tag for it. The key:roof tag is deprecated, except for “roof=no”, which has the most occurrences: https://wiki.openstreetmap.org/wiki/Key:roof. I added it to the latest version of the presets.

Using the BAR methodology for other types of natural disaster

I want to emphasize that the BAR methodology was designed by its authors for wind damage. Using it for other types of disasters, such as floods, may not be appropriate. From imagery showing floods, you can usually see how the road network is affected. You may also see flooded gardens. However, I don’t know how to evaluate whether the building itself is flooded or how to distinguish between three levels of damage using vertical imagery.

Reviewed tagging proposal

Damage tagging

damage:[event]:none,minimal,significant,complete,hidden,not_applicable

or if we want to be more specific:

damage:[event]:none,minimal,significant,complete,hidden_by_clouds, hidden_by_building,not_applicable

The absence of this tag indicates that the building was not evaluated.

Roof tagging

Since roof materials are a key factor in both the initial damage and future vulnerability when cyclone Chido hit, and since the tag may naturally evolve (especially in this cultural context, where people build their houses floor by floor over a long period of time), it makes sense to include it in an event tag.

roof:material:[event]=metal, concrete,[…],no_roof

While the material types are globally diverse, there are generally only two or three in every cultural context. The absence of a roof would also be noted.

Long term tagging?

I find the numerous existing tags (unrelated to damages) for the buildings in Mayotte really informative. But I know some OSM contributors would like the number of tags to be as minimal as possible. We can imagine a long term tagging made by the evaluation coordinator(s) for the whole affected area once the damage mapping is over. It would merge both the damage categories and the roof material. This tag would be:

damage:[event]=[none,minimal,significant,complete)roof(none, metal,concrete,wood,ceramic,straw…]

For Chido in Mayotte, we would have for example:

damage:Chido=significant_with_metal_roof or damage:Chido=none_with_concrete_roof

Context tags

Ideally, these tags would be set on changesets rather than on objects. Unfortunately, the Tasking Manager does not yet allow project managers to set changeset tags or aliases for the imagery source. For the latter, it uses the URL by default. These URLs are very long for the Pleiades imagery in Chido.

I used source:damage:Chido=CNES / Airbus, but some people thought it read strangely, as if the imagery were the source of the damage. Would source:damage_survey:Chido=CNES / Airbus solve this?

I think I will delete the damage:Chido:event=TC-2024-000225-COMtag. It provides the GLIDE number of the specific disaster, which can be found on this reference site. However, this should only be a changeset tag.

destroyed: lifecycle tag prefix

For those unfamiliar with the lifestyle approach proposed in 2015 aund used since, see its wiki page : Lifecycle prefix - OpenStreetMap Wiki. For destroyed:, see Key:destroyed - OpenStreetMap Wiki. I am not opposed to it, but it seems it still has an “in use” status, not an “approved” status.

I can edit the JOSM preset to replace the building=yes with destroyed:building=yes (or battle a bit with condition if we want to maintain other values). This would require to have a specific preset dialog for every damage class, but that is not a big deal.

1 Like

Hi all!

Bernard Heng from Humanitarian OpenStreetMap Team here.

Wanted to share some findings on our approach to damage tags in the Myanmar Earthquake Response. During early-response, HOT noted that familiarity and use of OSM in Myanmar is relatively low, with many of the affected townships facing an average of 85% OSM data gaps and local stakeholders not as familiar with OSM (e.g. exports and metadata/ tags). Given this, we decided to develop the following tagging structure:

- damage=yes

  • damage:event=2025MyanmarEQ
  • source:damage:date=2025-03-28
  • source:damage=Maxar

This approach took inspiration from this: https://wiki.openstreetmap.org/wiki/Building_damage_assessment. You can find example instructions in our Tasking Manager: https://tasks.hotosm.org/projects/25383/instructions .

Our primary reason is that this will allow us to retain building=yes and ensure that local users will still be able to extract out the OSM building footprints data, along with additional fields that will indicate if it was assessed to be damaged. Our issue with building=damaged will effectively “hide” these building footprints from OSM users who are not familiar with the tags and are not aware that they are downloading only a subset of the total building footprints.

Second, open satellite imagery after the disaster recovery and reconstruction stage may not always be available, such as in the case of Myanmar. It is also important that we factor ongoing shifts in the humanitarian landscape that may see lesser open resources available for use. The structure enable us to effectively “highlight” the building as damaged, while ensuring that the damaged building does not disappear semi-permanently from OSM pool of building footprints if we are not able to verify that the building is repaired and no longer damaged.

As we continue to work across unique disaster responses, we suspect a directory of different tagging structures for different disaster circumstances may be more applicable.

2 Likes