API Documentation | OpenStreetMap Taginfo Vietnam

<!DOCTYPE html> <html lang="en" dir="ltr"> <head profile="http://a9.com/-/spec/opensearch/1.1/"> <title>API Documentation | OpenStreetMap Taginfo Vietnam</title> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <meta name="content-language" content="en" /> <meta name="viewport" content="width=device-width, initial-scale=1"/> <link rel="stylesheet" type="text/css" href="/css/taginfo.css" /> <link rel="search" type="application/opensearchdescription+xml" href="/search/opensearch.xml" title="Taginfo Vietnam" /> <script id="context" type="application/json"> {"instance":"asia:vietnam","instances":{"australia-oceania:polynesie-francaise":"Polynésie française (French Polynesia)","australia-oceania:tokelau":"Tokelau","australia-oceania:new-zealand":"New Zealand","australia-oceania:wallis-et-futuna":"Wallis et Futuna","australia-oceania:niue":"Niue","australia-oceania:american-oceania":"American Oceania","australia-oceania:kiribati":"Kiribati","australia-oceania:marshall-islands":"Marshall Islands","australia-oceania:samoa":"Samoa","australia-oceania:ile-de-clipperton":"Île de Clipperton","australia-oceania:palau":"Palau","australia-oceania:cook-islands":"Cook Islands","australia-oceania:tuvalu":"Tuvalu","australia-oceania:papua-new-guinea":"Papua New Guinea","australia-oceania":"Australia and Oceania","australia-oceania:vanuatu":"Vanuatu","australia-oceania:tonga":"Tonga","australia-oceania:new-caledonia":"New Caledonia","australia-oceania:micronesia":"Micronesia","australia-oceania:fiji":"Fiji","australia-oceania:australia":"Australia","australia-oceania:nauru":"Nauru","australia-oceania:pitcairn-islands":"Pitcairn Islands","australia-oceania:solomon-islands":"Solomon Islands","europe:sweden":"Sweden","europe:slovenia":"Slovenia","europe:britain-and-ireland":"Britain and Ireland","europe:finland":"Finland","europe:denmark":"Denmark","europe:bulgaria":"Bulgaria","europe:hungary":"Hungary","europe:guernsey-jersey":"Guernsey and Jersey","europe:romania":"Romania","europe:turkey":"Turkey","europe:latvia":"Latvia","europe:liechtenstein":"Liechtenstein","europe:united-kingdom:scotland":"Scotland","europe:united-kingdom":"United Kingdom","europe:united-kingdom:wales":"Wales","europe:united-kingdom:england:greater-london":"Greater London","europe:united-kingdom:england:derbyshire":"Derbyshire","europe:united-kingdom:england:bristol":"Bristol","europe:united-kingdom:england:cheshire":"Cheshire","europe:united-kingdom:england:staffordshire":"Staffordshire","europe:united-kingdom:england:east-sussex":"East Sussex","europe:united-kingdom:england:suffolk":"Suffolk","europe:united-kingdom:england:essex":"Essex","europe:united-kingdom:england:lancashire":"Lancashire","europe:united-kingdom:england:nottinghamshire":"Nottinghamshire","europe:united-kingdom:england:cornwall":"Cornwall","europe:united-kingdom:england:west-yorkshire":"West Yorkshire","europe:united-kingdom:england:durham":"Durham","europe:united-kingdom:england:london:enfield":"Enfield","europe:united-kingdom:england:merseyside":"Merseyside","europe:united-kingdom:england:hertfordshire":"Hertfordshire","europe:united-kingdom:england:lincolnshire":"Lincolnshire","europe:united-kingdom:england:devon":"Devon","europe:united-kingdom:england:northumberland":"Northumberland","europe:united-kingdom:england:dorset":"Dorset","europe:united-kingdom:england:worcestershire":"Worcestershire","europe:united-kingdom:england:buckinghamshire":"Buckinghamshire","europe:united-kingdom:england":"England","europe:united-kingdom:england:shropshire":"Shropshire","europe:united-kingdom:england:north-yorkshire":"North Yorkshire","europe:united-kingdom:england:cambridgeshire":"Cambridgeshire","europe:united-kingdom:england:rutland":"Rutland","europe:united-kingdom:england:tyne-and-wear":"Tyne and Wear","europe:united-kingdom:england:greater-manchester":"Greater Manchester","europe:united-kingdom:england:leicestershire":"Leicestershire","europe:united-kingdom:england:norfolk":"Norfolk","europe:united-kingdom:england:west-midlands":"West Midlands","europe:united-kingdom:england:northamptonshire":"Northamptonshire","europe:united-kingdom:england:hampshire":"Hampshire","europe:united-kingdom:england:berkshire":"Berkshire","europe:united-kingdom:england:kent":"Kent","europe:united-kingdom:england:cumbria":"Cumbria","europe:united-kingdom:england:south-yorkshire":"South Yorkshire","europe:united-kingdom:england:warwickshire":"Warwickshire","europe:united-kingdom:england:west-sussex":"West Sussex","europe:united-kingdom:england:east-yorkshire-with-hull":"East Yorkshire with Hull","europe:united-kingdom:england:bedfordshire":"Bedfordshire","europe:united-kingdom:england:surrey":"Surrey","europe:united-kingdom:england:herefordshire":"Herefordshire","europe:united-kingdom:england:somerset":"Somerset","europe:united-kingdom:england:isle-of-wight":"Isle of Wight","europe:united-kingdom:england:wiltshire":"Wiltshire","europe:united-kingdom:england:gloucestershire":"Gloucestershire","europe:united-kingdom:england:oxfordshire":"Oxfordshire","europe:albania":"Albania","europe:norway":"Norway","europe:lithuania":"Lithuania","europe:georgia":"Georgia","europe:azores":"Azores","europe:estonia":"Estonia","europe:monaco":"Monaco","europe:czech-republic":"Czech Republic","europe:macedonia":"Macedonia","europe:luxembourg":"Luxembourg","europe":"Europe","europe:italy:isole":"Isole","europe:italy:nord-est":"Nord-Est","europe:italy":"Italy","europe:italy:nord-ovest":"Nord-Ovest","europe:italy:sud":"Sud","europe:italy:centro":"Centro","europe:dach":"Germany, Austria, Switzerland","europe:france:auvergne":"Auvergne","europe:france:nord-pas-de-calais":"Nord-Pas-de-Calais","europe:france:martinique":"Martinique","europe:france:picardie":"Picardie","europe:france:pays-de-la-loire":"Pays de la Loire","europe:france:bretagne":"Bretagne","europe:france:provence-alpes-cote-d-azur":"Provence Alpes-Cote-d'Azur","europe:france:lorraine":"Lorraine","europe:france:haute-normandie":"Haute-Normandie","europe:france:champagne-ardenne":"Champagne Ardenne","europe:france:basse-normandie":"Basse-Normandie","europe:france":"France","europe:france:alsace":"Alsace","europe:france:languedoc-roussillon":"Languedoc-Roussillon","europe:france:ile-de-france":"Ile-de-France","europe:france:aquitaine":"Aquitaine","europe:france:franche-comte":"Franche Comte","europe:france:guadeloupe":"Guadeloupe","europe:france:mayotte":"Mayotte","europe:france:guyane":"Guyane","europe:france:midi-pyrenees":"Midi-Pyrenees","europe:france:reunion":"Reunion","europe:france:poitou-charentes":"Poitou-Charentes","europe:france:centre":"Centre","europe:france:rhone-alpes":"Rhone-Alpes","europe:france:corse":"Corse","europe:france:limousin":"Limousin","europe:france:bourgogne":"Bourgogne","europe:poland:podlaskie":"Województwo podlaskie\u003Cbr />(Podlaskie Voivodeship)","europe:poland:malopolskie":"Województwo małopolskie\u003Cbr />(Lesser Poland Voivodeship)","europe:poland:wielkopolskie":"Województwo wielkopolskie\u003Cbr />(Greater Poland Voivodeship)","europe:poland:slaskie":"Województwo śląskie\u003Cbr />(Silesian Voivodeship)","europe:poland:podkarpackie":"Województwo podkarpackie\u003Cbr />(Subcarpathian Voivodeship)","europe:poland:warminsko-mazurskie":"Województwo warmińsko-mazurskie\u003Cbr />(Warmian-Masurian Voivodeship)","europe:poland:lodzkie":"Województwo łódzkie\u003Cbr />(Łódź Voivodeship)","europe:poland:pomorskie":"Województwo pomorskie\u003Cbr />(Pomeranian Voivodeship)","europe:poland:swietokrzyskie":"Województwo świętokrzyskie\u003Cbr />(Świętokrzyskie Voivodeship)","europe:poland:mazowieckie":"Województwo mazowieckie\u003Cbr />(Mazovian Voivodeship)","europe:poland:opolskie":"Województwo opolskie\u003Cbr />(Opole Voivodeship)","europe:poland":"Poland","europe:poland:zachodniopomorskie":"Województwo zachodniopomorskie\u003Cbr />(West Pomeranian Voivodeship)","europe:poland:kujawsko-pomorskie":"Województwo kujawsko-pomorskie\u003Cbr />(Kuyavian-Pomeranian Voivodeship)","europe:poland:dolnoslaskie":"Województwo dolnośląskie\u003Cbr />(Lower Silesian Voivodeship)","europe:poland:lubelskie":"Województwo lubelskie\u003Cbr />(Lublin Voivodeship)","europe:poland:lubuskie":"Województwo lubuskie\u003Cbr />(Lubusz Voivodeship)","europe:great-britain":"Great Britain","europe:alps":"Alps","europe:slovakia":"Slovakia","europe:serbia":"Serbia","europe:montenegro":"Montenegro","europe:spain:asturias":"Asturias","europe:spain:ceuta":"Ceuta","europe:spain:murcia":"Murcia","europe:spain:castilla-la-mancha":"Castilla-La Mancha","europe:spain:islas-baleares":"Islas Baleares","europe:spain:madrid":"Madrid","europe:spain:aragon":"Aragón","europe:spain":"Spain","europe:spain:castilla-y-leon":"Castilla y León","europe:spain:cantabria":"Cantabria","europe:spain:cataluna":"Cataluña","europe:spain:la-rioja":"La Rioja","europe:spain:melilla":"Melilla","europe:spain:extremadura":"Extremadura","europe:spain:andalucia":"Andalucía","europe:spain:pais-vasco":"País Vasco","europe:spain:galicia":"Galicia","europe:spain:valencia":"Valencia","europe:spain:navarra":"Navarra","europe:croatia":"Croatia","europe:austria":"Austria","europe:malta":"Malta","europe:ukraine":"Ukraine (with Crimea)","europe:switzerland":"Switzerland","europe:andorra":"Andorra","europe:germany:mecklenburg-vorpommern":"Mecklenburg-Vorpommern","europe:germany:brandenburg":"Brandenburg (mit Berlin)","europe:germany:bremen":"Bremen","europe:germany:bayern:oberbayern":"Oberbayern","europe:germany:bayern:schwaben":"Schwaben","europe:germany:bayern:oberpfalz":"Oberpfalz","europe:germany:bayern:oberfranken":"Oberfranken","europe:germany:bayern:unterfranken":"Unterfranken","europe:germany:bayern:mittelfranken":"Mittelfranken","europe:germany:bayern:niederbayern":"Niederbayern","europe:germany:bayern":"Bayern","europe:germany:hessen":"Hessen","europe:germany:schleswig-holstein":"Schleswig-Holstein","europe:germany":"Germany","europe:germany:hamburg":"Hamburg","europe:germany:berlin":"Berlin","europe:germany:niedersachsen":"Niedersachsen","europe:germany:baden-wuerttemberg:tuebingen-regbez":"Regierungsbezirk Tübingen","europe:germany:baden-wuerttemberg:freiburg-regbez":"Regierungsbezirk Freiburg","europe:germany:baden-wuerttemberg:karlsruhe-regbez":"Regierungsbezirk Karlsruhe","europe:germany:baden-wuerttemberg":"Baden-Württemberg","europe:germany:baden-wuerttemberg:stuttgart-regbez":"Regierungsbezirk Stuttgart","europe:germany:rheinland-pfalz":"Rheinland-Pfalz","europe:germany:sachsen":"Sachsen","europe:germany:thueringen":"Thüringen","europe:germany:nordrhein-westfalen:detmold-regbez":"Regierungsbezirk Detmold","europe:germany:nordrhein-westfalen:muenster-regbez":"Regierungsbezirk Münster","europe:germany:nordrhein-westfalen":"Nordrhein-Westfalen","europe:germany:nordrhein-westfalen:duesseldorf-regbez":"Regierungsbezirk Düsseldorf","europe:germany:nordrhein-westfalen:koeln-regbez":"Regierungsbezirk Köln","europe:germany:nordrhein-westfalen:arnsberg-regbez":"Regierungsbezirk Arnsberg","europe:germany:saarland":"Saarland","europe:germany:sachsen-anhalt":"Sachsen-Anhalt","europe:greece":"Greece","europe:cyprus":"Cyprus","europe:netherlands:utrecht":"Utrecht","europe:netherlands:groningen":"Groningen","europe:netherlands:drenthe":"Drenthe","europe:netherlands:zeeland":"Zeeland","europe:netherlands:friesland":"Friesland","europe:netherlands:flevoland":"Flevoland","europe:netherlands:overijssel":"Overijssel","europe:netherlands":"Netherlands","europe:netherlands:noord-holland":"Noord-Holland","europe:netherlands:zuid-holland":"Zuid-Holland","europe:netherlands:gelderland":"Gelderland","europe:netherlands:noord-brabant":"Noord-Brabant","europe:netherlands:limburg":"Limburg","europe:kosovo":"Kosovo","europe:isle-of-man":"Isle of Man","europe:faroe-islands":"Faroe Islands","europe:belgium":"Belgium","europe:iceland":"Iceland","europe:bosnia-herzegovina":"Bosnia-Herzegovina","europe:moldova":"Moldova","europe:ireland-and-northern-ireland":"Ireland and Northern Ireland","europe:portugal":"Portugal","europe:belarus":"Belarus","south-america:guyana":"Guyana","south-america:suriname":"Suriname","south-america:brazil:norte":"Norte","south-america:brazil:sul":"Sul","south-america:brazil:nordeste":"Nordeste","south-america:brazil":"Brazil","south-america:brazil:sudeste":"Sudeste","south-america:brazil:centro-oeste":"Centro-Oeste","south-america:bolivia":"Bolivia","south-america":"South America","south-america:colombia":"Colombia","south-america:chile":"Chile","south-america:uruguay":"Uruguay","south-america:ecuador":"Ecuador","south-america:peru":"Peru","south-america:argentina":"Argentina","south-america:paraguay":"Paraguay","south-america:venezuela":"Venezuela","asia:bangladesh":"Bangladesh","asia:north-korea":"North Korea","asia:uzbekistan":"Uzbekistan","asia:afghanistan":"Afghanistan","asia:indonesia:nusa-tenggara":"Nusa-Tenggara","asia:indonesia:sumatra":"Sumatra","asia:indonesia":"Indonesia (with East Timor)","asia:indonesia:sulawesi":"Sulawesi","asia:indonesia:kalimantan":"Kalimantan","asia:indonesia:maluku":"Maluku","asia:indonesia:java":"Java","asia:indonesia:papua":"Papua","asia:cambodia":"Cambodia","asia:bhutan":"Bhutan","asia:thailand":"Thailand","asia:china:tibet":"Tibet","asia:china:shandong":"Shandong","asia:china:shanghai":"Shanghai","asia:china:jilin":"Jilin","asia:china:jiangsu":"Jiangsu","asia:china:shaanxi":"Shaanxi","asia:china:fujian":"Fujian","asia:china:yunnan":"Yunnan","asia:china:liaoning":"Liaoning","asia:china:anhui":"Anhui","asia:china:qinghai":"Qinghai","asia:china:hainan":"Hainan","asia:china:inner-mongolia":"Inner Mongolia","asia:china:henan":"Henan","asia:china:hong:kong":"Hong Kong","asia:china:guangdong":"Guangdong (with Hong Kong and Macau)","asia:china:zhejiang":"Zhejiang","asia:china:tianjin":"Tianjin","asia:china:hubei":"Hubei","asia:china:hebei":"Hebei (with Beijing and Tianjin)","asia:china":"China","asia:china:hunan":"Hunan","asia:china:ningxia":"Ningxia","asia:china:shanxi":"Shanxi","asia:china:heilongjiang":"Heilongjiang","asia:china:sichuan":"Sichuan","asia:china:jiangxi":"Jiangxi","asia:china:inner:mongolia":"Inner Mongolia","asia:china:macau":"Macau","asia:china:guangxi":"Guangxi","asia:china:xinjiang":"Xinjiang","asia:china:gansu":"Gansu","asia:china:beijing":"Beijing","asia:china:hong-kong":"Hong Kong","asia:china:guizhou":"Guizhou","asia:china:chongqing":"Chongqing","asia:laos":"Laos","asia:tajikistan":"Tajikistan","asia:israel-and-palestine":"Israel and Palestine","asia:maldives":"Maldives","asia:iraq":"Iraq","asia:sri-lanka":"Sri Lanka","asia:turkmenistan":"Turkmenistan","asia:east-timor":"East Timor","asia:syria":"Syria","asia:gcc-states":"GCC States","asia:kazakhstan":"Kazakhstan","asia:yemen":"Yemen","asia":"Asia","asia:lebanon":"Lebanon","asia:myanmar":"Myanmar (a.k.a. Burma)","asia:india:eastern-zone":"Eastern Zone","asia:india:central-zone":"Central Zone","asia:india:southern-zone":"Southern Zone","asia:india":"India","asia:india:northern-zone":"Northern Zone","asia:india:western-zone":"Western Zone","asia:india:north-eastern-zone":"North-Eastern Zone","asia:vietnam":"Vietnam","asia:pakistan":"Pakistan","asia:philippines":"Philippines","asia:malaysia-singapore-brunei":"Malaysia, Singapore, and Brunei","asia:iran":"Iran","asia:japan:shikoku":"Shikoku","asia:japan:kyushu":"Kyūshū","asia:japan:kansai":"Kansai region (a.k.a. Kinki region)","asia:japan":"Japan","asia:japan:tohoku":"Tōhoku region","asia:japan:hokkaido":"Hokkaidō","asia:japan:chugoku":"Chūgoku region","asia:japan:kanto":"Kantō region","asia:japan:chubu":"Chūbu region","asia:nepal":"Nepal","asia:jordan":"Jordan","asia:taiwan":"Taiwan","asia:azerbaijan":"Azerbaijan","asia:armenia":"Armenia","asia:mongolia":"Mongolia","asia:kyrgyzstan":"Kyrgyzstan","asia:south-korea":"South Korea","africa:lesotho":"Lesotho","africa:cape-verde":"Cape Verde","africa:mauritius":"Mauritius","africa:congo-brazzaville":"Congo (Republic/Brazzaville)","africa:botswana":"Botswana","africa:eritrea":"Eritrea","africa:south-africa-and-lesotho":"South Africa (includes Lesotho)","africa:somalia":"Somalia","africa:gabon":"Gabon","africa:burundi":"Burundi","africa:swaziland":"Swaziland","africa:mauritania":"Mauritania","africa:cameroon":"Cameroon","africa:kenya":"Kenya","africa:ghana":"Ghana","africa:saint-helena-ascension-and-tristan-da-cunha":"Saint Helena, Ascension, and Tristan da Cunha","africa:chad":"Chad","africa:guinea":"Guinea","africa:sao-tome-and-principe":"Sao Tome and Principe","africa:algeria":"Algeria","africa:ethiopia":"Ethiopia","africa:egypt":"Egypt","africa":"Africa","africa:burkina-faso":"Burkina Faso","africa:benin":"Benin","africa:ivory-coast":"Ivory Coast","africa:niger":"Niger","africa:liberia":"Liberia","africa:south-sudan":"South Sudan","africa:angola":"Angola","africa:zimbabwe":"Zimbabwe","africa:uganda":"Uganda","africa:togo":"Togo","africa:senegal-and-gambia":"Senegal and Gambia","africa:morocco":"Morocco","africa:canary-islands":"Canary Islands","africa:mozambique":"Mozambique","africa:rwanda":"Rwanda","africa:guinea-bissau":"Guinea-Bissau","africa:libya":"Libya","africa:seychelles":"Seychelles","africa:madagascar":"Madagascar","africa:tanzania":"Tanzania","africa:sierra-leone":"Sierra Leone","africa:namibia":"Namibia","africa:tunisia":"Tunisia","africa:zambia":"Zambia","africa:mali":"Mali","africa:equatorial-guinea":"Equatorial Guinea","africa:congo-democratic-republic":"Congo (Democratic Republic/Kinshasa)","africa:malawi":"Malawi","africa:south-africa":"South Africa","africa:comores":"Comores","africa:sudan":"Sudan","africa:central-african-republic":"Central African Republic","africa:nigeria":"Nigeria","africa:djibouti":"Djibouti","central-america:panama":"Panama","central-america:cuba":"Cuba","central-america:honduras":"Honduras","central-america:belize":"Belize","central-america:costa-rica":"Costa Rica","central-america":"Central America","central-america:haiti-and-domrep":"Haiti and Dominican Republic","central-america:guatemala":"Guatemala","central-america:bahamas":"Bahamas","central-america:el-salvador":"El Salvador","central-america:jamaica":"Jamaica","central-america:nicaragua":"Nicaragua","north-america:us-pacific":"US Pacific","north-america:mexico":"Mexico","north-america:greenland":"Greenland","north-america:us-midwest":"US Midwest","north-america":"North America","north-america:us-northeast":"US Northeast","north-america:us:mississippi":"Mississippi","north-america:us:arkansas":"Arkansas","north-america:us:virginia":"Virginia","north-america:us:connecticut":"Connecticut","north-america:us:oregon":"Oregon","north-america:us:utah":"Utah","north-america:us:louisiana":"Louisiana","north-america:us:north-dakota":"North Dakota","north-america:us:us-virgin-islands":"United States Virgin Islands","north-america:us:new-hampshire":"New Hampshire","north-america:us:hawaii":"Hawaii","north-america:us:georgia":"Georgia","north-america:us:indiana":"Indiana","north-america:us:illinois":"Illinois","north-america:us:idaho":"Idaho","north-america:us:arizona":"Arizona","north-america:us:south-carolina":"South Carolina","north-america:us:tennessee":"Tennessee","north-america:us:ohio":"Ohio","north-america:us:alaska":"Alaska","north-america:us:rhode-island":"Rhode Island","north-america:us:south-dakota":"South Dakota","north-america:us:west-virginia":"West Virginia","north-america:us:alabama":"Alabama","north-america:us:kansas":"Kansas","north-america:us":"United States of America","north-america:us:wyoming":"Wyoming","north-america:us:wisconsin":"Wisconsin","north-america:us:iowa":"Iowa","north-america:us:district-of-columbia":"District of Columbia","north-america:us:massachusetts":"Massachusetts","north-america:us:kentucky":"Kentucky","north-america:us:missouri":"Missouri","north-america:us:texas":"Texas","north-america:us:montana":"Montana","north-america:us:nevada":"Nevada","north-america:us:oklahoma":"Oklahoma","north-america:us:vermont":"Vermont","north-america:us:pennsylvania":"Pennsylvania","north-america:us:michigan":"Michigan","north-america:us:puerto-rico":"Puerto Rico","north-america:us:colorado":"Colorado","north-america:us:north-carolina":"North Carolina","north-america:us:new-york":"New York","north-america:us:minnesota":"Minnesota","north-america:us:california:socal":"Southern California","north-america:us:california":"California","north-america:us:california:norcal":"Northern California","north-america:us:maryland":"Maryland","north-america:us:maine":"Maine","north-america:us:new-mexico":"New Mexico","north-america:us:florida":"Florida","north-america:us:washington":"Washington","north-america:us:delaware":"Delaware","north-america:us:new-jersey":"New Jersey","north-america:us:nebraska":"Nebraska","north-america:us-west":"US West","north-america:us-south":"US South","north-america:canada:nunavut":"Nunavut","north-america:canada:alberta":"Alberta","north-america:canada:ontario":"Ontario","north-america:canada":"Canada","north-america:canada:british-columbia":"British Columbia","north-america:canada:prince-edward-island":"Prince Edward Island","north-america:canada:quebec":"Quebec","north-america:canada:nova-scotia":"Nova Scotia","north-america:canada:saskatchewan":"Saskatchewan","north-america:canada:manitoba":"Manitoba","north-america:canada:yukon":"Yukon","north-america:canada:new-brunswick":"New Brunswick","north-america:canada:newfoundland-and-labrador":"Newfoundland and Labrador","north-america:canada:northwest-territories":"Northwest Territories","antarctica":"Antarctica","russia:northwestern-fed-district":"Northwestern Federal District","russia:siberian-fed-district":"Siberian Federal District","russia:ural-fed-district":"Ural Federal District","russia:central-fed-district":"Central Federal District","russia:volga-fed-district":"Volga Federal District","russia:south-fed-district":"South Federal District","russia:north-caucasus-fed-district":"North Caucasus Federal District","russia":"Russian Federation","russia:kaliningrad":"Kaliningrad","russia:far-eastern-fed-district":"Far Eastern Federal District","russia:crimean-fed-district":"Crimean Federal District"},"default_instance_selected":false,"lang":"en"} </script> <script> function generate_instance_list(path, type) { var level = -1; var ul = ""; var sel = ""; Object.keys(context.instances).sort().forEach(slug => { if (slug.startsWith("north-america:us-")) return; var pretty = context.instances[slug]; var lt = pretty.indexOf("<"); if (lt>0) pretty=pretty.substr(0,lt); var new_level = (slug.match(/:/g)||[]).length if (new_level > level) { ul += '<ul>'.repeat(new_level - level); } else if (new_level < level) { ul += '</ul>'.repeat(level - new_level); } ul += '<li><a href="/' + slug + path + '">' + pretty + '</a></li>'; level = new_level; sel += "<option "; if (slug == context.instance) sel += "selected "; sel += "value=\"" + slug + "\">" + "   ".repeat(level+1); if (level==0) sel += "<u>"; sel += pretty; if (level==0) sel += "</u>"; sel += "</option>"; }); if (level>0) ul += '</ul>'.repeat(level); return (type == 'ul') ? ul : sel; } </script> <script type="text/javascript" src="/js/taginfo.js"></script> <script type="text/javascript" src="/js/en/texts.js"></script></head> <body> <div id="tooltip"></div> <div id="menu-button-wrapper"> <div id="menu-button"></div> </div> <header> <div id="header_logo"> <a href="/"><img width="49" height="49" src="/img/logo/geofabrik.png" alt="taginfo"/></a> <a href="/"><img width="129" height="49" src="/img/logo/taginfo.png" alt="taginfo"/></a> <span id="header_instance"> <a href="/asia:vietnam/" id="instance">Vietnam</a> </span> </div> <div id="header_date" title="Last update of taginfo database" data-tooltip-position="OnLeft">Data from: 2024-11-25 21:06 UTC</div> <div id="header_forms_spacer"></div> <div id="header_forms" class="no-print"> <form id="set_instance"> <select id="instance_select" name="instance"></select> </form> <form id="set_language" action="/asia:vietnam/switch_locale"> <input type="hidden" id="url" name="url" value="/taginfo/apidoc"/> <select id="locale" name="locale"> <option value="ca">Català</option> <option value="de">Deutsch</option> <option value="en" selected="selected">English</option> <option value="es">Español</option> <option value="eo">Esperanto</option> <option value="fr">Français</option> <option value="gl">Galego</option> <option value="it">Italiano</option> <option value="hu">Magyar</option> <option value="nl">Nederlands</option> <option value="pl">Polski</option> <option value="pt">Português</option> <option value="pt-BR">(unknown)</option> <option value="vi">Tiếng Việt</option> <option value="ar">العربية</option> <option value="zh-hans">简体中文</option> <option value="zh-hant">繁體中文</option> <option value="cs">Čeština</option> <option value="ru">Русский</option> <option value="uk">Українська</option> <option value="fa">فارسی</option> <option value="ja">日本語</option> <option value="zh-CN">(unknown)</option> <option value="zh-TW">(unknown)</option> <option value="ko">한국어</option> </select> </form> <form id="search_form" action="/asia:vietnam/search"> <input type="text" id="search" name="q" value="" autocomplete="off" autocapitalize="off"/> <div id="suggestions"></div> </form> </div> </header> <nav> <ul id="menu" class="no-print"> <li><a href="/asia:vietnam/keys">Keys</a></li> <li><a href="/asia:vietnam/tags">Tags</a></li> <li><a href="/asia:vietnam/relations">Relations</a></li> <li><a href="/asia:vietnam/projects">Projects</a></li> <li><a href="/asia:vietnam/reports">Reports</a></li> <li><a href="/asia:vietnam/sources">Sources</a></li> <li><a href="/asia:vietnam/about">About</a></li> <li><a class="selected" href="/asia:vietnam/taginfo">Meta</a></li> </ul> </nav> <main> <div class="section_title"> <a class="section" href="/taginfo">Meta</a> </div> <div lang="en" dir="ltr"> <h1 class="section">API Documentation</h1> <p>See <a class="extlink" href="//wiki.openstreetmap.org/wiki/Taginfo/API">the OSM wiki</a> for general information about the API.</p> <h2>Table of Contents</h2> <ul> <li><a href="#api_4_key_chronology">/api/4/key/chronology</a></li> <li><a href="#api_4_key_combinations">/api/4/key/combinations</a></li> <li><a href="#api_4_key_distribution_nodes">/api/4/key/distribution/nodes</a></li> <li><a href="#api_4_key_distribution_ways">/api/4/key/distribution/ways</a></li> <li><a href="#api_4_key_overview">/api/4/key/overview</a></li> <li><a href="#api_4_key_prevalent_values">/api/4/key/prevalent_values</a></li> <li><a href="#api_4_key_projects">/api/4/key/projects</a></li> <li><a href="#api_4_key_similar">/api/4/key/similar</a></li> <li><a href="#api_4_key_stats">/api/4/key/stats</a></li> <li><a href="#api_4_key_values">/api/4/key/values</a></li> <li><a href="#api_4_key_wiki_pages">/api/4/key/wiki_pages</a></li> <li><a href="#api_4_keys_all">/api/4/keys/all</a></li> <li><a href="#api_4_keys_similar">/api/4/keys/similar</a></li> <li><a href="#api_4_keys_wiki_pages">/api/4/keys/wiki_pages</a></li> <li><a href="#api_4_keys_without_wiki_page">/api/4/keys/without_wiki_page</a></li> <li><a href="#api_4_languages">/api/4/languages</a></li> <li><a href="#api_4_project_icon">/api/4/project/icon</a></li> <li><a href="#api_4_project_tags">/api/4/project/tags</a></li> <li><a href="#api_4_projects_all">/api/4/projects/all</a></li> <li><a href="#api_4_projects_keys">/api/4/projects/keys</a></li> <li><a href="#api_4_projects_tags">/api/4/projects/tags</a></li> <li><a href="#api_4_relation_projects">/api/4/relation/projects</a></li> <li><a href="#api_4_relation_roles">/api/4/relation/roles</a></li> <li><a href="#api_4_relation_stats">/api/4/relation/stats</a></li> <li><a href="#api_4_relation_wiki_pages">/api/4/relation/wiki_pages</a></li> <li><a href="#api_4_relations_all">/api/4/relations/all</a></li> <li><a href="#api_4_search_by_key_and_value">/api/4/search/by_key_and_value</a></li> <li><a href="#api_4_search_by_keyword">/api/4/search/by_keyword</a></li> <li><a href="#api_4_search_by_role">/api/4/search/by_role</a></li> <li><a href="#api_4_search_by_value">/api/4/search/by_value</a></li> <li><a href="#api_4_site_config_geodistribution">/api/4/site/config/geodistribution</a></li> <li><a href="#api_4_site_info">/api/4/site/info</a></li> <li><a href="#api_4_site_sources">/api/4/site/sources</a></li> <li><a href="#api_4_tag_chronology">/api/4/tag/chronology</a></li> <li><a href="#api_4_tag_combinations">/api/4/tag/combinations</a></li> <li><a href="#api_4_tag_distribution_nodes">/api/4/tag/distribution/nodes</a></li> <li><a href="#api_4_tag_distribution_ways">/api/4/tag/distribution/ways</a></li> <li><a href="#api_4_tag_overview">/api/4/tag/overview</a></li> <li><a href="#api_4_tag_projects">/api/4/tag/projects</a></li> <li><a href="#api_4_tag_stats">/api/4/tag/stats</a></li> <li><a href="#api_4_tag_wiki_pages">/api/4/tag/wiki_pages</a></li> <li><a href="#api_4_tags_list">/api/4/tags/list</a></li> <li><a href="#api_4_tags_popular">/api/4/tags/popular</a></li> <li><a href="#api_4_unicode_characters">/api/4/unicode/characters</a></li> <li><a href="#api_4_wiki_languages">/api/4/wiki/languages</a></li> <li><a href="#api_4_wikidata_all">/api/4/wikidata/all</a></li> <li><a href="#api_4_wikidata_errors">/api/4/wikidata/errors</a></li> </ul> <a name="api_4_key_chronology"></a> <h2>/api/4/key/chronology</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/chronology</tt></td> </tr> <tr> <th>Description:</th> <td>Get chronology of key counts.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>date:</tt></td><td>TEXT</td><td>Date in format YYYY-MM-DD.</td></tr> <tr><td>    <tt>nodes:</tt></td><td>INT</td><td>Difference of number of nodes with this key relative to previous entry.</td></tr> <tr><td>    <tt>ways:</tt></td><td>INT</td><td>Difference of number of ways with this key relative to previous entry.</td></tr> <tr><td>    <tt>relations:</tt></td><td>INT</td><td>Difference of number of relations with this key relative to previous entry.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/chronology?key=highway" target="_blank">/api/4/key/chronology?key=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#chronology" target="_blank">/keys/highway#chronology</a></td> </tr> </table> <a name="api_4_key_combinations"></a> <h2>/api/4/key/combinations</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/combinations</tt></td> </tr> <tr> <th>Description:</th> <td>Find keys that are used together with a given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>query</tt> — Only show results where the other_key matches this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> — No filter.<br/><tt>nodes</tt> — Only values on tags used on nodes.<br/><tt>relations</tt> — Only values on tags used on relations.<br/><tt>ways</tt> — Only values on tags used on ways.</td> </tr> <tr> <th>Sort:</th> <td><tt>together_count</tt>, <tt>other_key</tt>, <tt>from_fraction</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>other_key:</tt></td><td>STRING</td><td>Other key.</td></tr> <tr><td>    <tt>together_count:</tt></td><td>INT</td><td>Number of objects that have both keys.</td></tr> <tr><td>    <tt>to_fraction:</tt></td><td>FLOAT</td><td>Fraction of objects with this key that also have the other key.</td></tr> <tr><td>    <tt>from_fraction:</tt></td><td>FLOAT</td><td>Fraction of objects with other key that also have this key.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/combinations?key=highway&page=1&rp=10&sortname=together_count&sortorder=desc" target="_blank">/api/4/key/combinations?key=highway&page=1&rp=10&sortname=together_count&sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#combinations" target="_blank">/keys/highway#combinations</a></td> </tr> </table> <a name="api_4_key_distribution_nodes"></a> <h2>/api/4/key/distribution/nodes</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/distribution/nodes</tt></td> </tr> <tr> <th>Description:</th> <td>Get map with distribution of this key in the database (nodes only).</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td>PNG image.</td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/distribution/nodes?key=amenity" target="_blank">/api/4/key/distribution/nodes?key=amenity</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/amenity#map" target="_blank">/keys/amenity#map</a></td> </tr> </table> <a name="api_4_key_distribution_ways"></a> <h2>/api/4/key/distribution/ways</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/distribution/ways</tt></td> </tr> <tr> <th>Description:</th> <td>Get map with distribution of this key in the database (ways only).</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td>PNG image.</td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/distribution/ways?key=highway" target="_blank">/api/4/key/distribution/ways?key=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#map" target="_blank">/keys/highway#map</a></td> </tr> </table> <a name="api_4_key_overview"></a> <h2>/api/4/key/overview</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/overview</tt></td> </tr> <tr> <th>Description:</th> <td>Show various data for given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results (always 1).</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>HASH</td><td>Hash with data.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>The tag key that was requested.</td></tr> <tr><td>    <tt>projects:</tt></td><td>INT</td><td>Number of projects mentioning this key.</td></tr> <tr><td>    <tt>users:</tt></td><td>INT</td><td>Number of users last editing objects with this key.</td></tr> <tr><td>    <tt>wiki_pages:</tt></td><td>ARRAY OF HASHES</td><td>Language codes for which wiki pages about this key are available.</td></tr> <tr><td>        <tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>        <tt>english:</tt></td><td>STRING</td><td>English name of this language.</td></tr> <tr><td>        <tt>native:</tt></td><td>STRING</td><td>Native name of this language.</td></tr> <tr><td>        <tt>dir:</tt></td><td>STRING</td><td>Printing direction for native name ("ltr", "rtl", or "auto")</td></tr> <tr><td>    <tt>has_map:</tt></td><td>BOOL</td><td>Is a map with the geographical distribution of this key available?</td></tr> <tr><td>    <tt>counts:</tt></td><td>ARRAY OF HASHES</td><td>Objects counts.</td></tr> <tr><td>        <tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>        <tt>count:</tt></td><td>INT</td><td>Number of objects with this type and key.</td></tr> <tr><td>        <tt>count_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>        <tt>values:</tt></td><td>INT</td><td>Number of different values for this key.</td></tr> <tr><td>    <tt>description:</tt></td><td>HASH OF HASHES</td><td>Description of this key (hash key is language code).</td></tr> <tr><td>        <tt>text:</tt></td><td>STRING</td><td>Description text.</td></tr> <tr><td>        <tt>dir:</tt></td><td>STRING</td><td>Printing direction for this language ("ltr", "rtl", or "auto").</td></tr> <tr><td>    <tt>prevalent_values:</tt></td><td>ARRAY OF HASHES</td><td>Prevalent values ordered by count from most often used down.</td></tr> <tr><td>        <tt>value:</tt></td><td>STRING</td><td>The tag value.</td></tr> <tr><td>        <tt>count:</tt></td><td>INT</td><td>Number of objects with this tag value.</td></tr> <tr><td>        <tt>fraction:</tt></td><td>FLOAT</td><td>Fraction of number of objects with this tag value compared to all objects.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/overview?key=amenity" target="_blank">/api/4/key/overview?key=amenity</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/amenity#overview" target="_blank">/keys/amenity#overview</a></td> </tr> </table> <a name="api_4_key_prevalent_values"></a> <h2>/api/4/key/prevalent_values</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/prevalent_values</tt></td> </tr> <tr> <th>Description:</th> <td>Get most prevalent values used with a given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>min_fraction</tt> — Only return values which are used in at least this percent of all objects with this key (optional, default = 0.01, minimum 0.01).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> — No filter.<br/><tt>nodes</tt> — Only values on tags used on nodes.<br/><tt>relations</tt> — Only values on tags used on relations.<br/><tt>ways</tt> — Only values on tags used on ways.</td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>count:</tt></td><td>INT</td><td>Number of times this key/value is in the OSM database.</td></tr> <tr><td>    <tt>fraction:</tt></td><td>FLOAT</td><td>Number of times in relation to number of times this key is in the OSM database.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/prevalent_values?key=highway&filter=ways" target="_blank">/api/4/key/prevalent_values?key=highway&filter=ways</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#overview" target="_blank">/keys/highway#overview</a></td> </tr> <tr> <th>Notes:</th> <td>Returns an additional row with <i>value null</i> and <i>count</i> the sum of the counts for all values not listed.</td> </tr> </table> <a name="api_4_key_projects"></a> <h2>/api/4/key/projects</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/projects</tt></td> </tr> <tr> <th>Description:</th> <td>Get projects using a given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>query</tt> — Only show results where the project name or tag value matches this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> — No filter.<br/><tt>nodes</tt> — Only values on tags used on nodes.<br/><tt>relations</tt> — Only values on tags used on relations.<br/><tt>ways</tt> — Only values on tags used on ways.</td> </tr> <tr> <th>Sort:</th> <td><tt>project_name</tt>, <tt>tag</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>project_id:</tt></td><td>STRING</td><td>Project ID</td></tr> <tr><td>    <tt>project_name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>    <tt>project_icon_url:</tt></td><td>STRING</td><td>Project icon URL</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>    <tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>    <tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>    <tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>    <tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>    <tt>icon_url:</tt></td><td>STRING</td><td>Icon URL</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/projects?key=highway&page=1&rp=10&sortname=project_name&sortorder=asc" target="_blank">/api/4/key/projects?key=highway&page=1&rp=10&sortname=project_name&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#projects" target="_blank">/keys/highway#projects</a></td> </tr> </table> <a name="api_4_key_similar"></a> <h2>/api/4/key/similar</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/similar</tt></td> </tr> <tr> <th>Description:</th> <td>Find keys that are similar to a given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>query</tt> — Only show results where the other_key matches this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>other_key</tt>, <tt>count_all</tt>, <tt>similarity</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>other_key:</tt></td><td>STRING</td><td>Other key.</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects that have the other key.</td></tr> <tr><td>    <tt>similarity:</tt></td><td>INT</td><td>An integer measuring the similarity of the two keys, smaller is more similar.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/similar?key=highway&page=1&rp=10&sortname=other_key&sortorder=asc" target="_blank">/api/4/key/similar?key=highway&page=1&rp=10&sortname=other_key&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#similar" target="_blank">/keys/highway#similar</a></td> </tr> </table> <a name="api_4_key_stats"></a> <h2>/api/4/key/stats</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/stats</tt></td> </tr> <tr> <th>Description:</th> <td>Show some database statistics for given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>    <tt>count:</tt></td><td>INT</td><td>Number of objects with this type and key.</td></tr> <tr><td>    <tt>count_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>    <tt>values:</tt></td><td>INT</td><td>Number of different values for this key.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/stats?key=amenity" target="_blank">/api/4/key/stats?key=amenity</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/amenity#overview" target="_blank">/keys/amenity#overview</a></td> </tr> </table> <a name="api_4_key_values"></a> <h2>/api/4/key/values</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/values</tt></td> </tr> <tr> <th>Description:</th> <td>Get values used with a given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>lang</tt> — Language for description (optional, default: 'en').<br/><tt>query</tt> — Only show results where the value matches this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> — No filter.<br/><tt>nodes</tt> — Only values on tags used on nodes.<br/><tt>relations</tt> — Only values on tags used on relations.<br/><tt>ways</tt> — Only values on tags used on ways.</td> </tr> <tr> <th>Sort:</th> <td><tt>value</tt>, <tt>count_all</tt>, <tt>count_nodes</tt>, <tt>count_ways</tt>, <tt>count_relations</tt>, <tt>in_wiki</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>count:</tt></td><td>INT</td><td>Number of times this key/value is in the OSM database.</td></tr> <tr><td>    <tt>fraction:</tt></td><td>FLOAT</td><td>Number of times in relation to number of times this key is in the OSM database.</td></tr> <tr><td>    <tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this tag?</td></tr> <tr><td>    <tt>desclang:</tt></td><td>STRING</td><td>Language the description of the tag is in.</td></tr> <tr><td>    <tt>descdir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description of the tag.</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Description of the tag from the wiki.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/values?key=highway&page=1&rp=10&sortname=count_ways&sortorder=desc" target="_blank">/api/4/key/values?key=highway&page=1&rp=10&sortname=count_ways&sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#values" target="_blank">/keys/highway#values</a></td> </tr> </table> <a name="api_4_key_wiki_pages"></a> <h2>/api/4/key/wiki_pages</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/key/wiki_pages</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of wiki pages in different languages describing a key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required)</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>    <tt>dir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description.</td></tr> <tr><td>    <tt>language:</tt></td><td>STRING</td><td>Language name in its language.</td></tr> <tr><td>    <tt>language_en:</tt></td><td>STRING</td><td>Language name in English.</td></tr> <tr><td>    <tt>title:</tt></td><td>STRING</td><td>Wiki page title.</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Short description of key from wiki page.</td></tr> <tr><td>    <tt>image:</tt></td><td>HASH</td><td>Associated image.</td></tr> <tr><td>        <tt>title:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>        <tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>        <tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>        <tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>        <tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>        <tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>        <tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr> <tr><td>    <tt>on_node:</tt></td><td>BOOL</td><td>Is this a key for nodes?</td></tr> <tr><td>    <tt>on_way:</tt></td><td>BOOL</td><td>Is this a key for ways?</td></tr> <tr><td>    <tt>on_area:</tt></td><td>BOOL</td><td>Is this a key for areas?</td></tr> <tr><td>    <tt>on_relation:</tt></td><td>BOOL</td><td>Is this a key for relations?</td></tr> <tr><td>    <tt>tags_implies:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags implied by this key.</td></tr> <tr><td>    <tt>tags_combination:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags that can be combined with this key.</td></tr> <tr><td>    <tt>tags_linked:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags related to this key.</td></tr> <tr><td>    <tt>status:</tt></td><td>STRING</td><td>Status of this key/tag.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/key/wiki_pages?key=highway" target="_blank">/api/4/key/wiki_pages?key=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#wiki" target="_blank">/keys/highway#wiki</a></td> </tr> <tr> <th>Notes:</th> <td>To get the complete thumbnail image URL, concatenate <tt>thumb_url_prefix</tt>, width of image in pixels, and <tt>thumb_url_suffix</tt>. The thumbnail image width must be smaller than <tt>width</tt>, use the <tt>image_url</tt> otherwise.</td> </tr> </table> <a name="api_4_keys_all"></a> <h2>/api/4/keys/all</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/keys/all</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of all keys.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show keys matching this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>characters_colon</tt> — Category B: Only show keys like category A but with one ore more colons (:) inside.<br/><tt>characters_letters</tt> — Category C: Only show keys like category B but with uppercase latin letters or letters from other scripts.<br/><tt>characters_plain</tt> — Category A: Only show keys with latin lowercase letters (a to z) or underscore (_), first and last characters must be letters.<br/><tt>characters_problem</tt> — Category E: Only show keys with problematic characters.<br/><tt>characters_rest</tt> — Category F: Only show keys not fitting in category A through E.<br/><tt>characters_space</tt> — Category D: Only show keys with at least one whitespace character (space, tab, new line, carriage return, or from other scripts).<br/><tt>in_wiki</tt> — Only show keys that appear in the wiki.<br/><tt>not_in_db</tt> — Only show keys that do not appear in the database.</td> </tr> <tr> <th>Sort:</th> <td><tt>key</tt>, <tt>count_all</tt>, <tt>count_nodes</tt>, <tt>count_ways</tt>, <tt>count_relations</tt>, <tt>values_all</tt>, <tt>users_all</tt>, <tt>in_wiki</tt>, <tt>length</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this key.</td></tr> <tr><td>    <tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>    <tt>count_nodes:</tt></td><td>INT</td><td>Number of nodes in the OSM database with this key.</td></tr> <tr><td>    <tt>count_nodes_fraction:</tt></td><td>FLOAT</td><td>Number of nodes in relation to all tagged nodes.</td></tr> <tr><td>    <tt>count_ways:</tt></td><td>INT</td><td>Number of ways in the OSM database with this key.</td></tr> <tr><td>    <tt>count_ways_fraction:</tt></td><td>FLOAT</td><td>Number of ways in relation to all ways.</td></tr> <tr><td>    <tt>count_relations:</tt></td><td>INT</td><td>Number of relations in the OSM database with this key.</td></tr> <tr><td>    <tt>count_relations_fraction:</tt></td><td>FLOAT</td><td>Number of relations in relation to all relations.</td></tr> <tr><td>    <tt>values_all:</tt></td><td>INT</td><td>Number of different values for this key.</td></tr> <tr><td>    <tt>users_all:</tt></td><td>INT</td><td>Number of users owning objects with this key.</td></tr> <tr><td>    <tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this key?</td></tr> <tr><td>    <tt>projects:</tt></td><td>INT</td><td>Number of projects using this key</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/keys/all?page=1&rp=10&filter=in_wiki&sortname=key&sortorder=asc" target="_blank">/api/4/keys/all?page=1&rp=10&filter=in_wiki&sortname=key&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys" target="_blank">/keys</a></td> </tr> </table> <a name="api_4_keys_similar"></a> <h2>/api/4/keys/similar</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/keys/similar</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of pairs of similar keys, one used very often, one used rarely.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show keys matching this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>key_common</tt>, <tt>key_rare</tt>, <tt>count_all_common</tt>, <tt>count_all_rare</tt>, <tt>similarity</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key_common:</tt></td><td>STRING</td><td>Key thats used often in OSM database</td></tr> <tr><td>    <tt>count_all_common:</tt></td><td>INT</td><td>Number of objects in the OSM database with the common key.</td></tr> <tr><td>    <tt>key_rare:</tt></td><td>STRING</td><td>Key thats used rarely in OSM database</td></tr> <tr><td>    <tt>count_all_rare:</tt></td><td>INT</td><td>Number of objects in the OSM database with the rare key.</td></tr> <tr><td>    <tt>similarity:</tt></td><td>INT</td><td>An integer measuring the similarity of the two keys, smaller is more similar.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/keys/similar?page=1&rp=10&sortname=count_all_common&sortorder=desc" target="_blank">/api/4/keys/similar?page=1&rp=10&sortname=count_all_common&sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/reports/similar_keys" target="_blank">/reports/similar_keys</a></td> </tr> </table> <a name="api_4_keys_wiki_pages"></a> <h2>/api/4/keys/wiki_pages</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/keys/wiki_pages</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of wiki pages in different languages for all keys.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show keys matching this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>key</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>lang:</tt></td><td>HASH</td><td>Hash with language codes as keys and values showing what type of wiki pages are available.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/keys/wiki_pages?page=1&rp=10&sortname=key&sortorder=asc" target="_blank">/api/4/keys/wiki_pages?page=1&rp=10&sortname=key&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/reports/language_comparison_table_for_keys_in_the_wiki" target="_blank">/reports/language_comparison_table_for_keys_in_the_wiki</a></td> </tr> </table> <a name="api_4_keys_without_wiki_page"></a> <h2>/api/4/keys/without_wiki_page</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/keys/without_wiki_page</tt></td> </tr> <tr> <th>Description:</th> <td>Return frequently used tag keys that have no associated wiki page.</td> </tr> <tr> <th>Parameters:</th> <td><tt>english</tt> — Check for key wiki pages in any language (0, default) or in the English language (1).<br/><tt>min_count</tt> — How many tags with this key must there be at least to show up here? (default 10000).<br/><tt>query</tt> — Only show results where the key matches this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>key</tt>, <tt>count_all</tt>, <tt>values_all</tt>, <tt>users_all</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in database with this key.</td></tr> <tr><td>    <tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Fraction of objects in database with this key.</td></tr> <tr><td>    <tt>values_all:</tt></td><td>INT</td><td>Number of different values for this key.</td></tr> <tr><td>    <tt>users_all:</tt></td><td>INT</td><td>Number of different users who own objects with this key.</td></tr> <tr><td>    <tt>prevalent_values:</tt></td><td>HASH</td><td>Often used values.</td></tr> <tr><td>        <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>        <tt>count:</tt></td><td>INT</td><td>Number of occurances of this value.</td></tr> <tr><td>        <tt>fraction:</tt></td><td>FLOAT</td><td>Fraction of all values.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/keys/without_wiki_page?min_count=1000&english=1&page=1&rp=10&sortname=count_all&sortorder=desc" target="_blank">/api/4/keys/without_wiki_page?min_count=1000&english=1&page=1&rp=10&sortname=count_all&sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/reports/frequently_used_keys_without_wiki_page" target="_blank">/reports/frequently_used_keys_without_wiki_page</a></td> </tr> </table> <a name="api_4_languages"></a> <h2>/api/4/languages</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/languages</tt></td> </tr> <tr> <th>Description:</th> <td>Get official subtags from the IETF BCP47 registry.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show entries matching this query (case insensitive substring match on subtags and description; optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>language</tt> — Show entries of type 'language' only.<br/><tt>region</tt> — Show entries of type 'region' only.<br/><tt>script</tt> — Show entries of type 'script' only.<br/><tt>variant</tt> — Show entries of type 'variant' only.</td> </tr> <tr> <th>Sort:</th> <td><tt>subtag</tt>, <tt>description</tt>, <tt>added</tt></td> </tr> <tr> <th>Result:</th> <td><pre>{ "type": STRING, "subtag": STRING, "description": STRING, "added": STRING, "notes": STRING }</pre></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/languages?page=1&rp=10&sortname=subtag&sortorder=asc" target="_blank">/api/4/languages?page=1&rp=10&sortname=subtag&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/sources/languages/subtags" target="_blank">/sources/languages/subtags</a></td> </tr> </table> <a name="api_4_project_icon"></a> <h2>/api/4/project/icon</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/project/icon</tt></td> </tr> <tr> <th>Description:</th> <td>Get icon of a project.</td> </tr> <tr> <th>Parameters:</th> <td><tt>project</tt> — Project ID (required)</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td>PNG image.</td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/project/icon?project=id_editor" target="_blank">/api/4/project/icon?project=id_editor</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/projects/id_editor" target="_blank">/projects/id_editor</a></td> </tr> </table> <a name="api_4_project_tags"></a> <h2>/api/4/project/tags</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/project/tags</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of all keys/tags used by a project.</td> </tr> <tr> <th>Parameters:</th> <td><tt>project</tt> — Project ID (required)</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>tag</tt>, <tt>count_all</tt>, <tt>in_wiki</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>    <tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>    <tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>    <tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>    <tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>    <tt>icon_url:</tt></td><td>STRING</td><td>Icon URL</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INTEGER</td><td>Number of objects with this key/tag in database</td></tr> <tr><td>    <tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this key/tag?</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/project/tags?project=id_editor&page=1&rp=10&sortname=tag&sortorder=asc" target="_blank">/api/4/project/tags?project=id_editor&page=1&rp=10&sortname=tag&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/projects/id_editor" target="_blank">/projects/id_editor</a></td> </tr> </table> <a name="api_4_projects_all"></a> <h2>/api/4/projects/all</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/projects/all</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of all projects using OSM tags known to taginfo.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show projects where name or description matches this query (substring match, optional).<br/><tt>status</tt> — Only show projects with given status (default is "OK")</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>name</tt>, <tt>unique_keys</tt>, <tt>unique_values</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>id:</tt></td><td>STRING</td><td>Project id</td></tr> <tr><td>    <tt>name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>    <tt>project_url:</tt></td><td>STRING</td><td>Project URL</td></tr> <tr><td>    <tt>icon_url:</tt></td><td>STRING</td><td>Icon URL</td></tr> <tr><td>    <tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Project description</td></tr> <tr><td>    <tt>key_entries:</tt></td><td>INT</td><td>Key entries for this project</td></tr> <tr><td>    <tt>tag_entries:</tt></td><td>INT</td><td>Tag entries for this project</td></tr> <tr><td>    <tt>unique_keys:</tt></td><td>INT</td><td>Unique keys known to this project</td></tr> <tr><td>    <tt>unique_tags:</tt></td><td>INT</td><td>Unique tags known to this project</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/projects/all?page=1&rp=10&sortname=name&sortorder=asc" target="_blank">/api/4/projects/all?page=1&rp=10&sortname=name&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/projects" target="_blank">/projects</a></td> </tr> </table> <a name="api_4_projects_keys"></a> <h2>/api/4/projects/keys</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/projects/keys</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of all keys used by at least one project.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show keys matching this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>key</tt>, <tt>projects</tt>, <tt>in_wiki</tt>, <tt>count_all</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>projects:</tt></td><td>INT</td><td>Number of projects using this key</td></tr> <tr><td>    <tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this key?</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this key.</td></tr> <tr><td>    <tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/projects/keys?page=1&rp=10&sortname=key&sortorder=asc" target="_blank">/api/4/projects/keys?page=1&rp=10&sortname=key&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/projects#keys" target="_blank">/projects#keys</a></td> </tr> </table> <a name="api_4_projects_tags"></a> <h2>/api/4/projects/tags</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/projects/tags</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of all tags used by at least one project.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show tags matching this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>key</tt>, <tt>value</tt>, <tt>projects</tt>, <tt>in_wiki</tt>, <tt>count_all</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>projects:</tt></td><td>INT</td><td>Number of projects using this tag</td></tr> <tr><td>    <tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this tag?</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/projects/tags?page=1&rp=10&sortname=tag&sortorder=asc" target="_blank">/api/4/projects/tags?page=1&rp=10&sortname=tag&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/projects#tags" target="_blank">/projects#tags</a></td> </tr> </table> <a name="api_4_relation_projects"></a> <h2>/api/4/relation/projects</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/relation/projects</tt></td> </tr> <tr> <th>Description:</th> <td>Get projects using a given relation type.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show results where the value matches this query (substring match, optional).<br/><tt>rtype</tt> — Relation type (required)</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>project_name</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>project_id:</tt></td><td>STRING</td><td>Project ID</td></tr> <tr><td>    <tt>project_name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>    <tt>project_icon_url:</tt></td><td>STRING</td><td>Project icon URL</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>    <tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>    <tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>    <tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>    <tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>    <tt>icon_url:</tt></td><td>STRING</td><td>Icon URL</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/relation/projects?rtype=route&page=1&rp=10&sortname=project_name&sortorder=asc" target="_blank">/api/4/relation/projects?rtype=route&page=1&rp=10&sortname=project_name&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/relations/route#projects" target="_blank">/relations/route#projects</a></td> </tr> </table> <a name="api_4_relation_roles"></a> <h2>/api/4/relation/roles</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/relation/roles</tt></td> </tr> <tr> <th>Description:</th> <td>Member role statistics for a relation of given type.</td> </tr> <tr> <th>Parameters:</th> <td><tt>min_fraction</tt> — Only return roles which are used in at least this percent of all members (optional).<br/><tt>query</tt> — Only show results where the role matches this query (substring match, optional).<br/><tt>rtype</tt> — Relation type (required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>role</tt>, <tt>count_all_members</tt>, <tt>count_node_members</tt>, <tt>count_way_members</tt>, <tt>count_relation_members</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>rtype:</tt></td><td>STRING</td><td>Relation type</td></tr> <tr><td>    <tt>role:</tt></td><td>STRING</td><td>Relation member role.</td></tr> <tr><td>    <tt>count_all_members:</tt></td><td>INT</td><td>Number of members with this role.</td></tr> <tr><td>    <tt>count_all_members_fraction:</tt></td><td>FLOAT</td><td>Number of members with this role devided by all members.</td></tr> <tr><td>    <tt>count_node_members:</tt></td><td>INT</td><td>Number of members of type node with this role.</td></tr> <tr><td>    <tt>count_node_members_fraction:</tt></td><td>FLOAT</td><td>Number of members of type node with this role devided by all members of type node.</td></tr> <tr><td>    <tt>count_way_members:</tt></td><td>INT</td><td>Number of members of type way with this role.</td></tr> <tr><td>    <tt>count_way_members_fraction:</tt></td><td>FLOAT</td><td>Number of members of type way with this role devided by all members of type way.</td></tr> <tr><td>    <tt>count_relation_members:</tt></td><td>INT</td><td>Number of members of type relation with this role.</td></tr> <tr><td>    <tt>count_relation_members_fraction:</tt></td><td>FLOAT</td><td>Number of members of type relation with this role devided by all members of type relation.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/relation/roles?rtype=multipolygon&page=1&rp=10" target="_blank">/api/4/relation/roles?rtype=multipolygon&page=1&rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/relations/multipolygon#roles" target="_blank">/relations/multipolygon#roles</a></td> </tr> <tr> <th>Notes:</th> <td>If the <i>query</i> parameter is not set and the <i>min_fraction</i> parameter is set and paging is disabled, the first row returned will have the role <i>null</i> and the counts are added up from all the results not shown due to the <i>min_fraction</i> parameter.</td> </tr> </table> <a name="api_4_relation_stats"></a> <h2>/api/4/relation/stats</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/relation/stats</tt></td> </tr> <tr> <th>Description:</th> <td>Show some database statistics for given relation type.</td> </tr> <tr> <th>Parameters:</th> <td><tt>rtype</tt> — Relation type (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>type:</tt></td><td>STRING</td><td>Member type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>    <tt>count:</tt></td><td>INT</td><td>Number of members with this type.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/relation/stats?rtype=multipolygon" target="_blank">/api/4/relation/stats?rtype=multipolygon</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/relations/multipolygon#overview" target="_blank">/relations/multipolygon#overview</a></td> </tr> </table> <a name="api_4_relation_wiki_pages"></a> <h2>/api/4/relation/wiki_pages</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/relation/wiki_pages</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of wiki pages in different languages describing a relation type.</td> </tr> <tr> <th>Parameters:</th> <td><tt>rtype</tt> — Relation type (required)</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>    <tt>language:</tt></td><td>STRING</td><td>Language name in its language.</td></tr> <tr><td>    <tt>language_en:</tt></td><td>STRING</td><td>Language name in English.</td></tr> <tr><td>    <tt>title:</tt></td><td>STRING</td><td>Wiki page title.</td></tr> <tr><td>    <tt>dir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description.</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Short description of key from wiki page.</td></tr> <tr><td>    <tt>image:</tt></td><td>HASH</td><td>Associated image.</td></tr> <tr><td>        <tt>title:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>        <tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>        <tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>        <tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>        <tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>        <tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>        <tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/relation/wiki_pages?rtype=multipolygon" target="_blank">/api/4/relation/wiki_pages?rtype=multipolygon</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/relations/multipolygon#wiki" target="_blank">/relations/multipolygon#wiki</a></td> </tr> <tr> <th>Notes:</th> <td>To get the complete thumbnail image URL, concatenate <tt>thumb_url_prefix</tt>, width of image in pixels, and <tt>thumb_url_suffix</tt>. The thumbnail image width must be smaller than <tt>width</tt>, use the <tt>image_url</tt> otherwise.</td> </tr> </table> <a name="api_4_relations_all"></a> <h2>/api/4/relations/all</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/relations/all</tt></td> </tr> <tr> <th>Description:</th> <td>Information about the different relation types.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show results where the relation type matches this query (substring match, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>rtype</tt>, <tt>count</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>rtype:</tt></td><td>STRING</td><td>Relation type</td></tr> <tr><td>    <tt>count:</tt></td><td>INT</td><td>Number of relations with this type.</td></tr> <tr><td>    <tt>count_fraction:</tt></td><td>INT</td><td>Number of relations with this type divided by the overall number of relations.</td></tr> <tr><td>    <tt>prevalent_roles:</tt></td><td>ARRAY</td><td>Prevalent member roles.</td></tr> <tr><td>        <tt>role:</tt></td><td>STRING</td><td>Member role</td></tr> <tr><td>        <tt>count:</tt></td><td>INT</td><td>Number of members with this role.</td></tr> <tr><td>        <tt>fraction:</tt></td><td>FLOAT</td><td>Number of members with this role divided by all members.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/relations/all?page=1&rp=10" target="_blank">/api/4/relations/all?page=1&rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/relations" target="_blank">/relations</a></td> </tr> <tr> <th>Notes:</th> <td>prevalent_roles can be null if taginfo doesn't have role information for this relation type, or an empty array when there are no roles with more than 1% of members</td> </tr> </table> <a name="api_4_search_by_key_and_value"></a> <h2>/api/4/search/by_key_and_value</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/search/by_key_and_value</tt></td> </tr> <tr> <th>Description:</th> <td>Search for tags by key and/or value.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Value to search for (substring search, required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>count_all</tt>, <tt>key</tt>, <tt>value</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the database with this tag.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/search/by_key_and_value?query=highway%3Dresidential&page=1&rp=10" target="_blank">/api/4/search/by_key_and_value?query=highway%3Dresidential&page=1&rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/search?q=highway%3Dresidential" target="_blank">/search?q=highway%3Dresidential</a></td> </tr> </table> <a name="api_4_search_by_keyword"></a> <h2>/api/4/search/by_keyword</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/search/by_keyword</tt></td> </tr> <tr> <th>Description:</th> <td>Search for keys and tags by keyword in wiki pages.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Value to search for (substring search, required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>key</tt>, <tt>value</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/search/by_keyword?query=fire&page=1&rp=10" target="_blank">/api/4/search/by_keyword?query=fire&page=1&rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/search?q=fire#fulltext" target="_blank">/search?q=fire#fulltext</a></td> </tr> </table> <a name="api_4_search_by_role"></a> <h2>/api/4/search/by_role</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/search/by_role</tt></td> </tr> <tr> <th>Description:</th> <td>Search for relation roles.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Role to search for (substring search, required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>count_all</tt>, <tt>rtype</tt>, <tt>role</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>rtype:</tt></td><td>STRING</td><td>Relation type.</td></tr> <tr><td>    <tt>role:</tt></td><td>STRING</td><td>Role</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the database with this role.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/search/by_role?query=foo&page=1&rp=10" target="_blank">/api/4/search/by_role?query=foo&page=1&rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/search?q=foo#roles" target="_blank">/search?q=foo#roles</a></td> </tr> </table> <a name="api_4_search_by_value"></a> <h2>/api/4/search/by_value</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/search/by_value</tt></td> </tr> <tr> <th>Description:</th> <td>Search for tags by value.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Value to search for (substring search, required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>count_all</tt>, <tt>key</tt>, <tt>value</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the database with this tag.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/search/by_value?query=foo&page=1&rp=10" target="_blank">/api/4/search/by_value?query=foo&page=1&rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/search?q=foo#values" target="_blank">/search?q=foo#values</a></td> </tr> </table> <a name="api_4_site_config_geodistribution"></a> <h2>/api/4/site/config/geodistribution</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/site/config/geodistribution</tt></td> </tr> <tr> <th>Description:</th> <td>Get information about the background map for distribution charts.</td> </tr> <tr> <th>Parameters:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>width:</tt></td><td>INT</td><td>width of background image</td></tr> <tr><td><tt>height:</tt></td><td>INT</td><td>height of background image</td></tr> <tr><td><tt>scale_image:</tt></td><td>FLOAT</td><td>scale factor for images</td></tr> <tr><td><tt>scale_compare_image:</tt></td><td>FLOAT</td><td>scale factor for comparison images</td></tr> <tr><td><tt>background_image:</tt></td><td>STRING</td><td>URL of background image</td></tr> <tr><td><tt>image_attribution:</tt></td><td>STRING</td><td>map attribution for comparison background</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/site/config/geodistribution" target="_blank">/api/4/site/config/geodistribution</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam" target="_blank"></a></td> </tr> </table> <a name="api_4_site_info"></a> <h2>/api/4/site/info</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/site/info</tt></td> </tr> <tr> <th>Description:</th> <td>Get information about this taginfo site.</td> </tr> <tr> <th>Parameters:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>url:</tt></td><td>STRING</td><td>URL</td></tr> <tr><td><tt>name:</tt></td><td>STRING</td><td>Name</td></tr> <tr><td><tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td><tt>icon:</tt></td><td>STRING</td><td>Path to icon which appears on the lop left corner of all pages.</td></tr> <tr><td><tt>contact:</tt></td><td>STRING</td><td>Contact information to admin.</td></tr> <tr><td><tt>area:</tt></td><td>STRING</td><td>Description of area covered.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/site/info" target="_blank">/api/4/site/info</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam" target="_blank"></a></td> </tr> </table> <a name="api_4_site_sources"></a> <h2>/api/4/site/sources</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/site/sources</tt></td> </tr> <tr> <th>Description:</th> <td>Get information about the data sources used.</td> </tr> <tr> <th>Parameters:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>id:</tt></td><td>STRING</td><td>Id</td></tr> <tr><td><tt>name:</tt></td><td>STRING</td><td>Name</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in taginfo.</td></tr> <tr><td><tt>update_start:</tt></td><td>STRING</td><td>Date/Timestamp when last update was started.</td></tr> <tr><td><tt>update_end:</tt></td><td>STRING</td><td>Date/Timestamp when last update was finished.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/site/sources" target="_blank">/api/4/site/sources</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/sources" target="_blank">/sources</a></td> </tr> </table> <a name="api_4_tag_chronology"></a> <h2>/api/4/tag/chronology</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/chronology</tt></td> </tr> <tr> <th>Description:</th> <td>Get chronology of tag counts.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>date:</tt></td><td>TEXT</td><td>Date in format YYYY-MM-DD.</td></tr> <tr><td>    <tt>nodes:</tt></td><td>INT</td><td>Difference of number of nodes with this tag relative to previous entry.</td></tr> <tr><td>    <tt>ways:</tt></td><td>INT</td><td>Difference of number of ways with this tag relative to previous entry.</td></tr> <tr><td>    <tt>relations:</tt></td><td>INT</td><td>Difference of number of relations with this tag relative to previous entry.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/chronology?key=highway&value=primary" target="_blank">/api/4/tag/chronology?key=highway&value=primary</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/highway=primary#chronology" target="_blank">/tags/highway=primary#chronology</a></td> </tr> </table> <a name="api_4_tag_combinations"></a> <h2>/api/4/tag/combinations</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/combinations</tt></td> </tr> <tr> <th>Description:</th> <td>Find keys and tags that are used together with a given tag.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>query</tt> — Only show results where the other_key or other_value matches this query (substring match, optional).<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> — No filter.<br/><tt>nodes</tt> — Only values on tags used on nodes.<br/><tt>relations</tt> — Only values on tags used on relations.<br/><tt>ways</tt> — Only values on tags used on ways.</td> </tr> <tr> <th>Sort:</th> <td><tt>together_count</tt>, <tt>other_tag</tt>, <tt>from_fraction</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>other_key:</tt></td><td>STRING</td><td>Other key.</td></tr> <tr><td>    <tt>other_value:</tt></td><td>STRING</td><td>Other value (may be empty).</td></tr> <tr><td>    <tt>together_count:</tt></td><td>INT</td><td>Number of objects that have both this tag and other key (or tag).</td></tr> <tr><td>    <tt>to_fraction:</tt></td><td>FLOAT</td><td>Fraction of objects with this tag that also have the other key (or tag).</td></tr> <tr><td>    <tt>from_fraction:</tt></td><td>FLOAT</td><td>Fraction of objects with other key (or tag) that also have this tag.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/combinations?key=highway&value=residential&page=1&rp=10&sortname=together_count&sortorder=desc" target="_blank">/api/4/tag/combinations?key=highway&value=residential&page=1&rp=10&sortname=together_count&sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/highway=residential#combinations" target="_blank">/tags/highway=residential#combinations</a></td> </tr> </table> <a name="api_4_tag_distribution_nodes"></a> <h2>/api/4/tag/distribution/nodes</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/distribution/nodes</tt></td> </tr> <tr> <th>Description:</th> <td>Get map with distribution of this tag in the database (nodes only). Will return empty image if there is no map available for this tag.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td>PNG image.</td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/distribution/nodes?key=amenity&value=post_box" target="_blank">/api/4/tag/distribution/nodes?key=amenity&value=post_box</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/amenity=post_box#map" target="_blank">/tags/amenity=post_box#map</a></td> </tr> </table> <a name="api_4_tag_distribution_ways"></a> <h2>/api/4/tag/distribution/ways</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/distribution/ways</tt></td> </tr> <tr> <th>Description:</th> <td>Get map with distribution of this tag in the database (ways only). Will return empty image if there is no map available for this tag.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td>PNG image.</td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/distribution/ways?key=highway&value=residential" target="_blank">/api/4/tag/distribution/ways?key=highway&value=residential</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/highway=residential#map" target="_blank">/tags/highway=residential#map</a></td> </tr> </table> <a name="api_4_tag_overview"></a> <h2>/api/4/tag/overview</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/overview</tt></td> </tr> <tr> <th>Description:</th> <td>Show various data for given tag.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results (always 1).</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>HASH</td><td>Hash with data.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>The tag key that was requested.</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>The tag value that was requested.</td></tr> <tr><td>    <tt>projects:</tt></td><td>INT</td><td>Number of projects mentioning this tag.</td></tr> <tr><td>    <tt>wiki_pages:</tt></td><td>ARRAY OF HASHES</td><td>Language codes for which wiki pages about this tag are available.</td></tr> <tr><td>        <tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>        <tt>english:</tt></td><td>STRING</td><td>English name of this language.</td></tr> <tr><td>        <tt>native:</tt></td><td>STRING</td><td>Native name of this language.</td></tr> <tr><td>        <tt>dir:</tt></td><td>STRING</td><td>Printing direction for native name ("ltr", "rtl", or "auto")</td></tr> <tr><td>    <tt>has_map:</tt></td><td>BOOL</td><td>Is a map with the geographical distribution of this tag available?</td></tr> <tr><td>    <tt>counts:</tt></td><td>ARRAY OF HASHES</td><td>Objects counts.</td></tr> <tr><td>        <tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>        <tt>count:</tt></td><td>INT</td><td>Number of objects with this type and tag.</td></tr> <tr><td>        <tt>count_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>    <tt>description:</tt></td><td>HASH OF HASHES</td><td>Description of this tag (hash key is language code).</td></tr> <tr><td>        <tt>text:</tt></td><td>STRING</td><td>Description text.</td></tr> <tr><td>        <tt>dir:</tt></td><td>STRING</td><td>Printing direction for this language ("ltr", "rtl", or "auto").</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/overview?key=amenity&value=restaurant" target="_blank">/api/4/tag/overview?key=amenity&value=restaurant</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/amenity=restaurant#overview" target="_blank">/tags/amenity=restaurant#overview</a></td> </tr> </table> <a name="api_4_tag_projects"></a> <h2>/api/4/tag/projects</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/projects</tt></td> </tr> <tr> <th>Description:</th> <td>Get projects using a given tag.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>query</tt> — Only show results where the project name matches this query (substring match, optional).<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> — No filter.<br/><tt>nodes</tt> — Only values on tags used on nodes.<br/><tt>relations</tt> — Only values on tags used on relations.<br/><tt>ways</tt> — Only values on tags used on ways.</td> </tr> <tr> <th>Sort:</th> <td><tt>project_name</tt>, <tt>tag</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>project_id:</tt></td><td>STRING</td><td>Project ID</td></tr> <tr><td>    <tt>project_name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>    <tt>project_icon_url:</tt></td><td>STRING</td><td>Project icon URL</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>    <tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>    <tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>    <tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>    <tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>    <tt>icon_url:</tt></td><td>STRING</td><td>Icon URL</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/projects?key=highway&value=residential&page=1&rp=10&sortname=project_name&sortorder=asc" target="_blank">/api/4/tag/projects?key=highway&value=residential&page=1&rp=10&sortname=project_name&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/highway=residential#projects" target="_blank">/tags/highway=residential#projects</a></td> </tr> </table> <a name="api_4_tag_stats"></a> <h2>/api/4/tag/stats</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/stats</tt></td> </tr> <tr> <th>Description:</th> <td>Show some database statistics for given tag.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required).<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>    <tt>count:</tt></td><td>INT</td><td>Number of objects with this type and tag.</td></tr> <tr><td>    <tt>count_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/stats?key=amenity&value=school" target="_blank">/api/4/tag/stats?key=amenity&value=school</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/amenity=school#overview" target="_blank">/tags/amenity=school#overview</a></td> </tr> </table> <a name="api_4_tag_wiki_pages"></a> <h2>/api/4/tag/wiki_pages</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tag/wiki_pages</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of wiki pages in different languages describing a tag.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Tag key (required)<br/><tt>value</tt> — Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>    <tt>dir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description.</td></tr> <tr><td>    <tt>language:</tt></td><td>STRING</td><td>Language name in its language.</td></tr> <tr><td>    <tt>language_en:</tt></td><td>STRING</td><td>Language name in English.</td></tr> <tr><td>    <tt>title:</tt></td><td>STRING</td><td>Wiki page title.</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>Short description of tag from wiki page.</td></tr> <tr><td>    <tt>image:</tt></td><td>HASH</td><td>Associated image.</td></tr> <tr><td>        <tt>title:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>        <tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>        <tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>        <tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>        <tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>        <tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>        <tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr> <tr><td>    <tt>on_node:</tt></td><td>BOOL</td><td>Is this a tag for nodes?</td></tr> <tr><td>    <tt>on_way:</tt></td><td>BOOL</td><td>Is this a tag for ways?</td></tr> <tr><td>    <tt>on_area:</tt></td><td>BOOL</td><td>Is this a tag for areas?</td></tr> <tr><td>    <tt>on_relation:</tt></td><td>BOOL</td><td>Is this a tag for relations?</td></tr> <tr><td>    <tt>tags_implies:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags implied by this tag.</td></tr> <tr><td>    <tt>tags_combination:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags that can be combined with this tag.</td></tr> <tr><td>    <tt>tags_linked:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags related to this tag.</td></tr> <tr><td>    <tt>status:</tt></td><td>STRING</td><td>Status of this key/tag.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tag/wiki_pages?key=highway&value=residential" target="_blank">/api/4/tag/wiki_pages?key=highway&value=residential</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags/highway=residential#wiki" target="_blank">/tags/highway=residential#wiki</a></td> </tr> <tr> <th>Notes:</th> <td>To get the complete thumbnail image URL, concatenate <tt>thumb_url_prefix</tt>, width of image in pixels, and <tt>thumb_url_suffix</tt>. The thumbnail image width must be smaller than <tt>width</tt>, use the <tt>image_url</tt> otherwise.</td> </tr> </table> <a name="api_4_tags_list"></a> <h2>/api/4/tags/list</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tags/list</tt></td> </tr> <tr> <th>Description:</th> <td>Get information on given tags or all tags documented on the wiki with given key.</td> </tr> <tr> <th>Parameters:</th> <td><tt>key</tt> — Key (optional)<br/><tt>tags</tt> — Comma-separated list of tags in format key1=value1a,value1b,...,key2=value2a,value2b,... (optional).</td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>in_wiki:</tt></td><td>BOOL</td><td>In there at least one wiki page for this tag?</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>    <tt>count_nodes:</tt></td><td>INT</td><td>Number of nodes in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_nodes_fraction:</tt></td><td>FLOAT</td><td>Number of nodes in relation to all tagged nodes.</td></tr> <tr><td>    <tt>count_ways:</tt></td><td>INT</td><td>Number of ways in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_ways_fraction:</tt></td><td>FLOAT</td><td>Number of ways in relation to all ways.</td></tr> <tr><td>    <tt>count_relations:</tt></td><td>INT</td><td>Number of relations in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_relations_fraction:</tt></td><td>FLOAT</td><td>Number of relations in relation to all relations.</td></tr> <tr><td>    <tt>on_node:</tt></td><td>BOOL</td><td>Is this a tag for nodes?</td></tr> <tr><td>    <tt>on_way:</tt></td><td>BOOL</td><td>Is this a tag for ways?</td></tr> <tr><td>    <tt>on_area:</tt></td><td>BOOL</td><td>Is this a tag for areas?</td></tr> <tr><td>    <tt>on_relation:</tt></td><td>BOOL</td><td>Is this a tag for relations?</td></tr> <tr><td>    <tt>wiki:</tt></td><td>HASH</td><td>Hash with language codes as keys and values are hashes with the following keys:</td></tr> <tr><td>        <tt>description:</tt></td><td>STRING</td><td>Description of this tag.</td></tr> <tr><td>        <tt>image:</tt></td><td>HASH</td><td>Optional hash with information about descriptive image:</td></tr> <tr><td>            <tt>image:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>            <tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>            <tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>            <tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>            <tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>            <tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>            <tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr> <tr><td>        <tt>osmcarto_rendering:</tt></td><td>HASH</td><td>Optional hash with information about default rendering:</td></tr> <tr><td>            <tt>image:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>            <tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>            <tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>            <tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>            <tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>            <tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>            <tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tags/list?tags=highway=primary,secondary,amenity=post_box" target="_blank">/api/4/tags/list?tags=highway=primary,secondary,amenity=post_box</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam" target="_blank"></a></td> </tr> <tr> <th>Notes:</th> <td>You have to either use the <tt>key</tt> parameter or the <tt>tags</tt> parameter.</td> </tr> </table> <a name="api_4_tags_popular"></a> <h2>/api/4/tags/popular</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/tags/popular</tt></td> </tr> <tr> <th>Description:</th> <td>Get list of most often used tags.</td> </tr> <tr> <th>Parameters:</th> <td><tt>query</tt> — Only show tags matching this query (substring match in key and value, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>tag</tt>, <tt>count_all</tt>, <tt>count_nodes</tt>, <tt>count_ways</tt>, <tt>count_relations</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>    <tt>in_wiki:</tt></td><td>BOOL</td><td>In there at least one wiki page for this tag?</td></tr> <tr><td>    <tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>    <tt>count_nodes:</tt></td><td>INT</td><td>Number of nodes in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_nodes_fraction:</tt></td><td>FLOAT</td><td>Number of nodes in relation to all tagged nodes.</td></tr> <tr><td>    <tt>count_ways:</tt></td><td>INT</td><td>Number of ways in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_ways_fraction:</tt></td><td>FLOAT</td><td>Number of ways in relation to all ways.</td></tr> <tr><td>    <tt>count_relations:</tt></td><td>INT</td><td>Number of relations in the OSM database with this tag.</td></tr> <tr><td>    <tt>count_relations_fraction:</tt></td><td>FLOAT</td><td>Number of relations in relation to all relations.</td></tr> <tr><td>    <tt>projects:</tt></td><td>INT</td><td>Number of projects using this tag</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/tags/popular?page=1&rp=10&sortname=tag&sortorder=asc" target="_blank">/api/4/tags/popular?page=1&rp=10&sortname=tag&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/tags" target="_blank">/tags</a></td> </tr> </table> <a name="api_4_unicode_characters"></a> <h2>/api/4/unicode/characters</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/unicode/characters</tt></td> </tr> <tr> <th>Description:</th> <td>Get information about unicode characters.</td> </tr> <tr> <th>Parameters:</th> <td><tt>string</tt> — Character string (required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>char:</tt></td><td>TEXT</td><td>Unicode character.</td></tr> <tr><td>    <tt>codepoint:</tt></td><td>INT</td><td>Unicode code point.</td></tr> <tr><td>    <tt>script:</tt></td><td>TEXT</td><td>Code (Xxxx) of script this character is in.</td></tr> <tr><td>    <tt>script_name:</tt></td><td>TEXT</td><td>Name of script this character is in.</td></tr> <tr><td>    <tt>category:</tt></td><td>TEXT</td><td>Unicode general category (Xx) of this character.</td></tr> <tr><td>    <tt>name:</tt></td><td>TEXT</td><td>Unicode name of this character (null if unknown).</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/unicode/characters?string=highway" target="_blank">/api/4/unicode/characters?string=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/keys/highway#characters" target="_blank">/keys/highway#characters</a></td> </tr> </table> <a name="api_4_wiki_languages"></a> <h2>/api/4/wiki/languages</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/wiki/languages</tt></td> </tr> <tr> <th>Description:</th> <td>List languages taginfo knows about and how many wiki pages describing keys and tags there are in these languages.</td> </tr> <tr> <th>Parameters:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Paging:</th> <td>no</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>code</tt>, <tt>native_name</tt>, <tt>english_name</tt>, <tt>wiki_key_pages</tt>, <tt>wiki_tag_pages</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>code:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>    <tt>dir:</tt></td><td>STRING</td><td>Direction this language is written in ("ltr", "rtl", or "auto").</td></tr> <tr><td>    <tt>native_name:</tt></td><td>STRING</td><td>Name of language in this language.</td></tr> <tr><td>    <tt>english_name:</tt></td><td>STRING</td><td>Name of language in English.</td></tr> <tr><td>    <tt>wiki_key_pages:</tt></td><td>INT</td><td>Number of "Key" wiki pages in this language.</td></tr> <tr><td>    <tt>wiki_key_pages_fraction:</tt></td><td>FLOAT</td><td>Number of "Key" wiki pages in this language in relation to the number of keys described in any language in the wiki.</td></tr> <tr><td>    <tt>wiki_tag_pages:</tt></td><td>INT</td><td>Number of "Tag" wiki pages in this language.</td></tr> <tr><td>    <tt>wiki_tag_pages_fraction:</tt></td><td>FLOAT</td><td>Number of "Tag" wiki pages in this language in relation to the number of tags described in any language in the wiki.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/wiki/languages?sortname=wiki_key_pages&sortorder=desc" target="_blank">/api/4/wiki/languages?sortname=wiki_key_pages&sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/reports/languages" target="_blank">/reports/languages</a></td> </tr> </table> <a name="api_4_wikidata_all"></a> <h2>/api/4/wikidata/all</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/wikidata/all</tt></td> </tr> <tr> <th>Description:</th> <td>Get all wikidata entries about keys, tags, and relations.</td> </tr> <tr> <th>Parameters:</th> <td><tt>lang</tt> — Language for description (optional, default: 'en').<br/><tt>query</tt> — Only show results matching this string (substring match on key/value/rtype/item code/item description, optional).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>type</tt>, <tt>ktr</tt>, <tt>item</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>type:</tt></td><td>STRING</td><td>One of 'key', 'tag', or 'relation'.</td></tr> <tr><td>    <tt>item:</tt></td><td>STRING</td><td>The wikidata items Q or P code.</td></tr> <tr><td>    <tt>description:</tt></td><td>STRING</td><td>The description of the wikidata item.</td></tr> <tr><td>    <tt>key:</tt></td><td>STRING</td><td>The OSM key related to this item (set for key and 'tag' type).</td></tr> <tr><td>    <tt>value:</tt></td><td>STRING</td><td>The value of the OSM tag related to this item (set for 'tag' type).</td></tr> <tr><td>    <tt>rtype:</tt></td><td>STRING</td><td>The OSM relation type related to this item (set for 'relation' type).</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/wikidata/all?lang=fr&page=1&rp=10&sortname=item&sortorder=asc" target="_blank">/api/4/wikidata/all?lang=fr&page=1&rp=10&sortname=item&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/sources/wikidata/items" target="_blank">/sources/wikidata/items</a></td> </tr> </table> <a name="api_4_wikidata_errors"></a> <h2>/api/4/wikidata/errors</h2> <table class="desc"> <tr> <th>Path:</th> <td><tt>/api/4/wikidata/errors</tt></td> </tr> <tr> <th>Description:</th> <td>Get import errors for wikidata source.</td> </tr> <tr> <th>Parameters:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><span class="empty">none</span></td> </tr> <tr> <th>Sort:</th> <td><tt>item</tt></td> </tr> <tr> <th>Result:</th> <td><table class="apiresults"><tr><td><tt>total:</tt></td><td>INT</td><td>Total number of results.</td></tr> <tr><td><tt>page:</tt></td><td>INT</td><td>Result page number (first has page number 1).</td></tr> <tr><td><tt>rp:</tt></td><td>INT</td><td>Results per page.</td></tr> <tr><td><tt>url:</tt></td><td>STRING</td><td>URL of the request.</td></tr> <tr><td><tt>data_until:</tt></td><td>STRING</td><td>All changes in the source until this date are reflected in this taginfo result.</td></tr> <tr><td><tt>data:</tt></td><td>ARRAY OF HASHES</td><td>Array with results.</td></tr> <tr><td>    <tt>item:</tt></td><td>STRING</td><td>The wikidata items Q or P code.</td></tr> <tr><td>    <tt>propvalue:</tt></td><td>STRING</td><td>The wikidata item property value.</td></tr> <tr><td>    <tt>desciption:</tt></td><td>STRING</td><td>The description of the wikidata item.</td></tr> <tr><td>    <tt>error:</tt></td><td>STRING</td><td>The error message.</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="/asia:vietnam/api/4/wikidata/errors?page=1&rp=10&sortname=item&sortorder=asc" target="_blank">/api/4/wikidata/errors?page=1&rp=10&sortname=item&sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="/asia:vietnam/sources/wikidata/errors" target="_blank">/sources/wikidata/errors</a></td> </tr> </table> </div> </main> <footer class="no-print"> <div id="footer_left"><span id="osmlink"><a class="extlink" href="//www.openstreetmap.org/"><b>OpenStreetMap</b></a> ·</span> <a href="//www.openstreetmap.org/copyright">Data © OSM contributors (ODbL)</a></div> <div id="footer_right"> <a href="/asia:vietnam/taginfo/apidoc">API</a> · <a id="help-link" target="_blank" href="/asia:vietnam/help">Help</a> · <a class="extlink" href="//wiki.openstreetmap.org/wiki/Taginfo">Wiki</a> </div> </footer> <script> document.getElementById("instance_select").addEventListener("change", function() { var path = window.location.href; var match = path.indexOf(context.instance); if (match > -1) { path = path.substring(match + context.instance.length); } else { path = ""; } window.location.href = "/" + this.value + path; }); document.getElementById("instance_select").innerHTML = generate_instance_list('', 'select'); </script> <div id="javascriptmsg">This website only works with Javascript! Please enable Javascript in your browser.</div> <script>document.getElementById('javascriptmsg').remove();</script> </body> </html>

CINXE.COM

API Documentation | OpenStreetMap Taginfo Vietnam