Key:contact:*

Prefix contact:*
Description
The contact:* keys describe contact information.
Group: Addresses
Used on these elements
See also
Status: in use
taginfo: contact:*

This page describes a key prefix rather than a simple key.

The prefix for several contact:*=* keys to describe contact information.

Values

You should only add contact information to POIs and not to any private address!

Email-addresses which are only available on a website after solving a captcha, or which are in other ways obfuscated to protect against SPAM-bots should not be tagged in OSM. The same applies to fax and phone numbers.

This article or section contains questionable, contentious or controversial information. See the talk page for more information.
Some details below are incompatible with phone numbers outside of Germany or when written in languages other than German.

What is used here: phone and fax number format ( DIN 5008): +<country_code> <national_destination_code> <subscriber_number>-<direct_inward_dialing>

Contact

Key Value Element Comment Taginfo Photo

Contact details

contact:phone +44 11223 456-789 Telephone number ( DIN 5008 format: +<country_code> <national_destination_code> <subscriber_number>-<direct_inward_dialling>). See also the more popular phone=*.)
contact:website http://example.com Website-url (see also the more popular website=* and website:*=*)
contact:email mail@example.com E-mail address (see also the more popular email=*)
contact:fax +44 11223 456-789 A dedicated telephone number connecting to a telefacsimile (fax) machine. See also the more popular fax=*).
contact:mobile +44 11223 456-789 A telephone number connecting to a mobile phone. The more general tag contact:phone=* should be preferred.
contact:tty +44 11223 456-789 A dedicated telephone number connecting to a teletypewriter (tty).
Key Value Element Comment Taginfo Photo

Social media, messengers, web services

contact:facebook full facebook URL Facebook profile - preferably the full URL (because there are many different kinds of pages in facebook), though simply the public username is also used. (see also facebook=*)
contact:vk VK.com VK link to social network service
contact:instagram Username Instagram account name or full URL
contact:twitter OpenStreetMap Twitter account name or full URL (see also twitter=*)
contact:youtube Youtube account/channel URL YouTube URL of account or channel officially used by the POI. Sometimes only the YouTube username is indicated.
contact:ok ok URL ok link to social network service.
contact:webcam webcam URL For denoting a webcam's location, use a node with the tag surveillance:type=camera. See also Webcams for more information
contact:telegram https://t.me/Example or Telegram number Telegram account name or full URL or Telegram number officially used by the POI.
contact:whatsapp WhatsApp number WhatsApp number officially used by the POI.
contact:linkedin Username LinkedIn account name or full URL
contact:pinterest Pinterest URL Pinterest URL officially used by the POI.
contact:viber +44 11223 456-789 Viber account name (phone number) or full URL
contact:foursquare https://foursquare.com/v/Example Foursquare account name (hash) or full URL
contact:skype SkypeName Skype login name
contact:xing Username XING account name or full URL
contact:tiktok Username TikTok account name or full URL
contact:vhf VHF Channel or Frequency Of interest for maritime and airport services
contact:flickr Flickr URL Flickr URL. Similar to all others, this is where the POI can be officially contacted, or where they broadcast information. This should not point to a self-taken photo depicting the POI.
contact:mastodon username@server.example Mastodon social network handle or full URL
contact:sip sip@example.com SIP address
contact:diaspora username@server.example Diaspora social network handle or full URL
contact:gnusocial username@server.example GNU Social social network handle or full URL
contact:user_defined user defined All commonly used namespace keys according to Taginfo
Key Value Element Comment Taginfo Photo

Mail address

contact:street street name For use when the contact address is not the same as the address of the physical location.

For denoting the street name where a POI is located, see also addr:street=*
contact:housenumber housenumber For use when the contact address is not the same as the address of the physical location. (Status: "draft" )

For denoting the housenumber where a POI is located, see also addr:housenumber=*
contact:postcode postcode For use when the contact address is not the same as the address of the physical location.

For denoting the postcode number where a POI is located, see also addr:postcode=*
contact:city city name For use when the contact address is not the same as the address of the physical location.

For denoting the city name where a POI is located, see also addr:city=*
contact:country country For use when the contact address is not the same as the address of the physical location.

For denoting the country where a POI is located, see also addr:country=*
contact:pobox Post Box Number Companies and organizations sometimes have a Post Office Box (P.O. Box/ PO Box) to send mail to instead of to their physical address. See also addr:postbox=*

This table is a wiki template with a default description in English. Editable here.

Addressing scheme in France

Note that in France (especially), contact:housenumber keys are mostly used on POIs to add their addresses without consideration of whether the physical address is different from the postal address but instead of addr: keys reserved for mapping addresses as unique features.

This usage is relatively widespread, see TagInfo contact:housenumber page, it has not yet (2022-08-30) been approved by the community.

A draft about this usage called "Schéma de Charlieu" can be found on the OSM wiki.

Qwant Maps promotes the display of the values of these POIs labels when they exist.

Existing tagging schemes

For the most common keys, the shorter version outside the 'contact' scheme is used more frequently: phone=*, fax=*, email=* and website=*, with other contact tags used rarely outside the namespace scheme. Both schemes have been in use for a long time and still exist in parallel. Many applications are able to use both of them.

At the same time a proposal to deprecate contact:phone=* was not successful - Discussions/tagging/contact:phone or phone. Idea of deprecating either tags without contact: prefix or ones with contact prefix is repeatedly suggested, often triggering huge discussion and ending with conclusion that there is no consensus. Please, read past discussion before starting a new one[1][2][3][4].

There were also attempts to deprecate, mechanically retag or promote either version of many other contact tags[6]

See also

  • phone=* - A telephone number associated with the object
  • website=* - Specifying the link to the official website for a feature
  • email=* - An email address associated with the object
  • url=* - Specifying an url related to a feature
  • fax=* - A fax number associated with the object
  • Bremen Schema - A schema that proposes to add contact information about a POI to the node via using contact:* instead of adding addr:*
  • Key:operator#Further details - subkeys used to add further detail about the operator
  • emergency:phone=* - A phone number for emergencies associated with the object
  • addr:*=* - addr is the prefix for several addr:* keys to describe addresses

References

  1. ↑ https://lists.openstreetmap.org/pipermail/tagging/2019-December/thread.html#49474 - December 2019 thread
  2. ↑ https://lists.openstreetmap.org/pipermail/tagging/2019-August/thread.html#47668 August 2019 Thread
  3. ↑ https://lists.openstreetmap.org/pipermail/tagging/2020-May/thread.html#52379 - May 2020 thread, over 50 messages
  4. ↑ https://lists.openstreetmap.org/pipermail/tagging/2022-January/thread.html#63734 January 2022 thread
  5. ↑ Contact:website / website / url
  6. ↑ Proposed features/Social media contact prefix
This article is issued from Openstreetmap. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.