Tag:amenity=embassy

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.

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:

• office=diplomatic - for all embassies, consulates and other diplomatic offices
• diplomatic=embassy - to specify an embassy or similar diplomatic office
• diplomatic=consulate - for a consulate or similar office
• diplomatic=liaison - for a liaison office or similar
• embassy=* - used to specify the type of embassy

Deprecatedː add amenity=embassy on a node placed at the centrepoint of the building, or on a closed way (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:xx=* key, where xx 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];

• To specify if visa services or citizen services (such as passport renewals or document requests) are available:
  • diplomatic:services:non-immigrant_visas=yes/no - Availability of non-immigrant visa services (such as tourist and short-term student, work, or business visas) at the embassy
  • diplomatic:services:immigrant_visas=yes/no - Availability of immigrant visa services at the embassy
  • diplomatic:services:citizen_services=yes/no - Availability of passport and other document services, for citizens of the sending country of embassy

Deprecation Follow-up

Deprecation vote

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

Transition stats

• Use history of the amenity=embassy tag: https://taghistory.raifer.tech/#***/amenity/embassy
• Use history of both amenity=embassy and office=diplomatic tags: https://taghistory.raifer.tech/#***/amenity/embassy&***/office/diplomatic

Tasks

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

Documentation

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 ?

Tools

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://git.omaps.dev/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 ?

Render

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

• office=diplomatic
• Proposed features/office=diplomatic.

Related terms: ‹ embassy › ‹ consulate › ‹ diplomatic office ›