From OpenStreetMap Wiki
Jump to navigation Jump to search

exclamation mark

This feature has been labeled as deprecated. The recommended replacement is: office=diplomatic.
The reason is documented in Deprecated features. You are still free to continue to use or interpret this tag as you see fit since OpenStreetMap does not have “banned features”.
Under no circumstances should you (semi-)automatically change “deprecated” tags to something else in the database on a large scale without conforming to the automated edits code of conduct. Any such change will be reverted.
Public-images-osm logo.svg amenity = embassy
Palais Metternich2.jpg
Formerly used tag to map a representation of a country in another country. Edit or translate this description.
Group: Amenities
Used on these elements
may be used on nodesshould not be used on waysmay be used on areasshould not be used on relations
Useful combination
Status: deprecatedPage for proposal

 Embassy is the official office of a country in another country (for example in the capital). This tag is used for embassies, but also for ambassadors’ residences, consulates and other diplomatic facilities.

How to map

There is a new approved tag office=diplomatic which covers diplomatic facilities. Consider adding:

Deprecatedː add amenity=embassy on a node node placed at the centrepoint of the building, or on a closed way (area) area drawn around the perimeter of the embassy.

Additional Tags

Tag Notes
name=* Common name of the embassy in the local language, eg. "Embassy of the Russian Federation“ for a Russian embassy in the U.S. You can add names in other languages using a suffix in the name:lg=* key, where lg is the language code of that name (please only add official names and not unofficial translations). See also Multilingual names.
official_name=* The complete, official name of the embassy or diplomatic office, often longer than the commonly-used name.
short_name=* Since official names can be difficult and unwieldy at times, it should be considered to add a colloquial name like Norwegian Embassy using short _name=* or alt_name=*. Such an alternate name helps users to retrieve the desired information from the database.
diplomatic=* Used to specify the nature of the diplomatic institution (e.g. embassy, consulate, liaison office, etc.).
country=* Represented country, use ISO 3166-1 alpha-2 country code (upper case, details below).
target=* Targeted country, use ISO 3166-1 alpha-2 country code (upper case, details below).

To add the country code tag it with country=<ISO 3166-1 alpha-2 country code> (list of all country codes at Wikipedia). For example for the British embassy in the United States use country=GB (please use upper case, lower case is for language codes).

Types of embassies

Use office=diplomatic with the additional tags to specify the type of embassy, consulate or diplomatic office:

    • diplomatic=* with key values of [embassy, consulate, liaison]
      • embassy=* with key values of [yes, high_commission, nunciature, interests_section, mission, delegation, branch_embassy, residence]
      • consulate=* with key values of {yes, consulate_general, consular_agency, consular_office, honorary_consul]
      • liaison=* with key values of [liaison_office, representative_office, subnational];

Deprecation Follow-up

Deprecation vote

This tag has been formally deprecated by a community vote on 2018-12-01.

Transition stats


Please help the community to transition from amenity=embassy to office=diplomatic + diplomatic=̽* with the following tasks:

MapRoulette challenge

Manual review of all deprecated tagged embassyː https://maproulette.org/browse/challenges/23980


Task English Every other language Comment
Update amenity=* wiki page yes N/A
Update amenity=embassy wiki page yes N/A
Update office=diplomatic wiki page yes yes
Update diplomatic=* wiki page N/A N/A
Update the deprecated features page yes N/A
Update every other mentioning the amenity=embassy tag (listed here) excluding users & discussion pages Unknown Unknown
Update deprecated amenity=embassy data item yes N/A
Update approuved office=diplomatic + diplomatic data item yes N/A
[Please add any documentation that might be relevant] N/A N/A
How to use this table ?


See https://taginfo.openstreetmap.org/tags/amenity=embassy for more details about the tools using this tag.

Mission Task amenity=embassy tag deprecated office=diplomatic + diplomatic=̽* tags supported URL of the request Comment
For every editorː change preset Update JOSM preset yes yes https://josm.openstreetmap.de/ticket/17562
Update ID preset yes yes https://github.com/openstreetmap/iD/issues/6144
Update Vespucci preset yes yes https://github.com/simonpoole/beautified-JOSM-preset/issues/143
Update Organic Maps preset yes yes https://github.com/organicmaps/organicmaps/issues/1072
Update MAPS.ME preset no no send by email to support@maps.me on 2022-08-31
For every Q/A toolsː suggest to enforce the proposal Create a JOSM/Validator preset yes yes https://josm.openstreetmap.de/ticket/17562
Other toolsː suggest to enforce the proposal [Please add any editor, tool, search engine, router, render or other project that might be relevant] N/A N/A N/A N/A
How to use this table ?


See https://taginfo.openstreetmap.org/tags/amenity=embassy to find out which renders are using this tag.

Mission Task amenity=embassy tag deprecated office=diplomatic + diplomatic=̽* tags supported URL of the request Comment
Render Update standard tile layer render yes yes https://github.com/gravitystorm/openstreetmap-carto/pull/4168
Update tile.openstreetmap.fr render yes yes https://github.com/cquest/osmfr-cartocss/issues/90
[Please add any render that might be relevant] N/A N/A N/A N/A
How to use this table ?

See also