CINXE.COM

API Documentation | OpenStreetMap Hungary Taginfo

<!DOCTYPE html> <html lang="en" dir="ltr"> <head profile="http://a9.com/-/spec/opensearch/1.1/"> <title>API Documentation | OpenStreetMap Hungary Taginfo</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 Hungary Instance" /> <script id="context" type="application/json"> {"instance":"","lang":"en"} </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_date" title="Last update of taginfo database" data-tooltip-position="OnLeft">Data from: 2024-12-09 21:17 UTC</div> <div id="header_forms" class="no-print"> <form id="set_language" action="/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="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="ko">한국어</option> </select> </form> <form id="search_form" action="/search"> <input type="text" id="search" name="q" value="" autocomplete="off" autocapitalize="off"/> <div id="suggestions"></div> </form> </div> <div id="header_logo"> <a href="/"><img width="49" height="49" src="/img/logo/hunflag.png" alt="taginfo"/></a> <a href="/"><img width="129" height="49" src="/img/logo/taginfo.png" alt="taginfo"/></a> </div> </header> <nav> <ul id="menu" class="no-print"> <li><a href="/keys">Keys</a></li> <li><a href="/tags">Tags</a></li> <li><a href="/relations">Relations</a></li> <li><a href="/projects">Projects</a></li> <li><a href="/reports">Reports</a></li> <li><a href="/sources">Sources</a></li> <li><a href="/about">About</a></li> <li><a class="selected" href="/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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>date:</tt></td><td>TEXT</td><td>Date in format YYYY-MM-DD.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>nodes:</tt></td><td>INT</td><td>Difference of number of nodes with this key relative to previous entry.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>ways:</tt></td><td>INT</td><td>Difference of number of ways with this key relative to previous entry.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;chronology?key=highway" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;chronology?key=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#chronology" target="_blank">&#x2F;keys&#x2F;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> &mdash; Tag key (required).<br/><tt>query</tt> &mdash; 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> &mdash; No filter.<br/><tt>nodes</tt> &mdash; Only values on tags used on nodes.<br/><tt>relations</tt> &mdash; Only values on tags used on relations.<br/><tt>ways</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>other_key:</tt></td><td>STRING</td><td>Other key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>together_count:</tt></td><td>INT</td><td>Number of objects that have both keys.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;combinations?key=highway&amp;page=1&amp;rp=10&amp;sortname=together_count&amp;sortorder=desc" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;combinations?key=highway&amp;page=1&amp;rp=10&amp;sortname=together_count&amp;sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#combinations" target="_blank">&#x2F;keys&#x2F;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> &mdash; 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="&#x2F;api&#x2F;4&#x2F;key&#x2F;distribution&#x2F;nodes?key=amenity" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;distribution&#x2F;nodes?key=amenity</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;amenity#map" target="_blank">&#x2F;keys&#x2F;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> &mdash; 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="&#x2F;api&#x2F;4&#x2F;key&#x2F;distribution&#x2F;ways?key=highway" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;distribution&#x2F;ways?key=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#map" target="_blank">&#x2F;keys&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>The tag key that was requested.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>projects:</tt></td><td>INT</td><td>Number of projects mentioning this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>users:</tt></td><td>INT</td><td>Number of users last editing objects with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>english:</tt></td><td>STRING</td><td>English name of this language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>native:</tt></td><td>STRING</td><td>Native name of this language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>dir:</tt></td><td>STRING</td><td>Printing direction for native name ("ltr", "rtl", or "auto")</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>has_map:</tt></td><td>BOOL</td><td>Is a map with the geographical distribution of this key available?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>counts:</tt></td><td>ARRAY OF HASHES</td><td>Objects counts.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of objects with this type and key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>values:</tt></td><td>INT</td><td>Number of different values for this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>HASH OF HASHES</td><td>Description of this key (hash key is language code).</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>text:</tt></td><td>STRING</td><td>Description text.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>dir:</tt></td><td>STRING</td><td>Printing direction for this language ("ltr", "rtl", or "auto").</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>The tag value.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of objects with this tag value.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;overview?key=amenity" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;overview?key=amenity</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;amenity#overview" target="_blank">&#x2F;keys&#x2F;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> &mdash; Tag key (required).<br/><tt>min_fraction</tt> &mdash; 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> &mdash; No filter.<br/><tt>nodes</tt> &mdash; Only values on tags used on nodes.<br/><tt>relations</tt> &mdash; Only values on tags used on relations.<br/><tt>ways</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of times this key/value is in the OSM database.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;prevalent_values?key=highway&amp;filter=ways" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;prevalent_values?key=highway&amp;filter=ways</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#overview" target="_blank">&#x2F;keys&#x2F;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> &mdash; Tag key (required).<br/><tt>query</tt> &mdash; 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> &mdash; No filter.<br/><tt>nodes</tt> &mdash; Only values on tags used on nodes.<br/><tt>relations</tt> &mdash; Only values on tags used on relations.<br/><tt>ways</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_id:</tt></td><td>STRING</td><td>Project ID</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_icon_url:</tt></td><td>STRING</td><td>Project icon URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;projects?key=highway&amp;page=1&amp;rp=10&amp;sortname=project_name&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;projects?key=highway&amp;page=1&amp;rp=10&amp;sortname=project_name&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#projects" target="_blank">&#x2F;keys&#x2F;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> &mdash; Tag key (required).<br/><tt>query</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>other_key:</tt></td><td>STRING</td><td>Other key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INT</td><td>Number of objects that have the other key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;similar?key=highway&amp;page=1&amp;rp=10&amp;sortname=other_key&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;similar?key=highway&amp;page=1&amp;rp=10&amp;sortname=other_key&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#similar" target="_blank">&#x2F;keys&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of objects with this type and key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;stats?key=amenity" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;stats?key=amenity</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;amenity#overview" target="_blank">&#x2F;keys&#x2F;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> &mdash; Tag key (required).<br/><tt>lang</tt> &mdash; Language for description (optional, default: 'en').<br/><tt>query</tt> &mdash; 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> &mdash; No filter.<br/><tt>nodes</tt> &mdash; Only values on tags used on nodes.<br/><tt>relations</tt> &mdash; Only values on tags used on relations.<br/><tt>ways</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of times this key/value is in the OSM database.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this tag?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>desclang:</tt></td><td>STRING</td><td>Language the description of the tag is in.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>descdir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description of the tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;values?key=highway&amp;page=1&amp;rp=10&amp;sortname=count_ways&amp;sortorder=desc" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;values?key=highway&amp;page=1&amp;rp=10&amp;sortname=count_ways&amp;sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#values" target="_blank">&#x2F;keys&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>dir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>language:</tt></td><td>STRING</td><td>Language name in its language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>language_en:</tt></td><td>STRING</td><td>Language name in English.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>title:</tt></td><td>STRING</td><td>Wiki page title.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Short description of key from wiki page.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>image:</tt></td><td>HASH</td><td>Associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>title:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_node:</tt></td><td>BOOL</td><td>Is this a key for nodes?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_way:</tt></td><td>BOOL</td><td>Is this a key for ways?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_area:</tt></td><td>BOOL</td><td>Is this a key for areas?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_relation:</tt></td><td>BOOL</td><td>Is this a key for relations?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>tags_implies:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags implied by this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>tags_linked:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags related to this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;key&#x2F;wiki_pages?key=highway" target="_blank">&#x2F;api&#x2F;4&#x2F;key&#x2F;wiki_pages?key=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#wiki" target="_blank">&#x2F;keys&#x2F;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> &mdash; 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> &mdash; Category B: Only show keys like category A but with one ore more colons (:) inside.<br/><tt>characters_letters</tt> &mdash; Category C: Only show keys like category B but with uppercase latin letters or letters from other scripts.<br/><tt>characters_plain</tt> &mdash; 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> &mdash; Category E: Only show keys with problematic characters.<br/><tt>characters_rest</tt> &mdash; Category F: Only show keys not fitting in category A through E.<br/><tt>characters_space</tt> &mdash; 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> &mdash; Only show keys that appear in the wiki.<br/><tt>not_in_db</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_nodes:</tt></td><td>INT</td><td>Number of nodes in the OSM database with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_nodes_fraction:</tt></td><td>FLOAT</td><td>Number of nodes in relation to all tagged nodes.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_ways:</tt></td><td>INT</td><td>Number of ways in the OSM database with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_ways_fraction:</tt></td><td>FLOAT</td><td>Number of ways in relation to all ways.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_relations:</tt></td><td>INT</td><td>Number of relations in the OSM database with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_relations_fraction:</tt></td><td>FLOAT</td><td>Number of relations in relation to all relations.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>values_all:</tt></td><td>INT</td><td>Number of different values for this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>users_all:</tt></td><td>INT</td><td>Number of users owning objects with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this key?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;keys&#x2F;all?page=1&amp;rp=10&amp;filter=in_wiki&amp;sortname=key&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;keys&#x2F;all?page=1&amp;rp=10&amp;filter=in_wiki&amp;sortname=key&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key_common:</tt></td><td>STRING</td><td>Key thats used often in OSM database</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key_rare:</tt></td><td>STRING</td><td>Key thats used rarely in OSM database</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;keys&#x2F;similar?page=1&amp;rp=10&amp;sortname=count_all_common&amp;sortorder=desc" target="_blank">&#x2F;api&#x2F;4&#x2F;keys&#x2F;similar?page=1&amp;rp=10&amp;sortname=count_all_common&amp;sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;reports&#x2F;similar_keys" target="_blank">&#x2F;reports&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;keys&#x2F;wiki_pages?page=1&amp;rp=10&amp;sortname=key&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;keys&#x2F;wiki_pages?page=1&amp;rp=10&amp;sortname=key&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;reports&#x2F;language_comparison_table_for_keys_in_the_wiki" target="_blank">&#x2F;reports&#x2F;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> &mdash; Check for key wiki pages in any language (0, default) or in the English language (1).<br/><tt>min_count</tt> &mdash; How many tags with this key must there be at least to show up here? (default 10000).<br/><tt>query</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INT</td><td>Number of objects in database with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Fraction of objects in database with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>values_all:</tt></td><td>INT</td><td>Number of different values for this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>users_all:</tt></td><td>INT</td><td>Number of different users who own objects with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>prevalent_values:</tt></td><td>HASH</td><td>Often used values.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of occurances of this value.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;keys&#x2F;without_wiki_page?min_count=1000&amp;english=1&amp;page=1&amp;rp=10&amp;sortname=count_all&amp;sortorder=desc" target="_blank">&#x2F;api&#x2F;4&#x2F;keys&#x2F;without_wiki_page?min_count=1000&amp;english=1&amp;page=1&amp;rp=10&amp;sortname=count_all&amp;sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;reports&#x2F;frequently_used_keys_without_wiki_page" target="_blank">&#x2F;reports&#x2F;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> &mdash; 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> &mdash; Show entries of type 'language' only.<br/><tt>region</tt> &mdash; Show entries of type 'region' only.<br/><tt>script</tt> &mdash; Show entries of type 'script' only.<br/><tt>variant</tt> &mdash; 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="&#x2F;api&#x2F;4&#x2F;languages?page=1&amp;rp=10&amp;sortname=subtag&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;languages?page=1&amp;rp=10&amp;sortname=subtag&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;sources&#x2F;languages&#x2F;subtags" target="_blank">&#x2F;sources&#x2F;languages&#x2F;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> &mdash; 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="&#x2F;api&#x2F;4&#x2F;project&#x2F;icon?project=id_editor" target="_blank">&#x2F;api&#x2F;4&#x2F;project&#x2F;icon?project=id_editor</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;projects&#x2F;id_editor" target="_blank">&#x2F;projects&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>icon_url:</tt></td><td>STRING</td><td>Icon URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INTEGER</td><td>Number of objects with this key/tag in database</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;project&#x2F;tags?project=id_editor&amp;page=1&amp;rp=10&amp;sortname=tag&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;project&#x2F;tags?project=id_editor&amp;page=1&amp;rp=10&amp;sortname=tag&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;projects&#x2F;id_editor" target="_blank">&#x2F;projects&#x2F;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> &mdash; Only show projects where name or description matches this query (substring match, optional).<br/><tt>status</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>id:</tt></td><td>STRING</td><td>Project id</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_url:</tt></td><td>STRING</td><td>Project URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>icon_url:</tt></td><td>STRING</td><td>Icon URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Project description</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key_entries:</tt></td><td>INT</td><td>Key entries for this project</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>tag_entries:</tt></td><td>INT</td><td>Tag entries for this project</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>unique_keys:</tt></td><td>INT</td><td>Unique keys known to this project</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;projects&#x2F;all?page=1&amp;rp=10&amp;sortname=name&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;projects&#x2F;all?page=1&amp;rp=10&amp;sortname=name&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;projects" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>projects:</tt></td><td>INT</td><td>Number of projects using this key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this key?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;projects&#x2F;keys?page=1&amp;rp=10&amp;sortname=key&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;projects&#x2F;keys?page=1&amp;rp=10&amp;sortname=key&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;projects#keys" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>projects:</tt></td><td>INT</td><td>Number of projects using this tag</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>in_wiki:</tt></td><td>BOOL</td><td>Is there at least one wiki page for this tag?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;projects&#x2F;tags?page=1&amp;rp=10&amp;sortname=tag&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;projects&#x2F;tags?page=1&amp;rp=10&amp;sortname=tag&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;projects#tags" target="_blank">&#x2F;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> &mdash; Only show results where the value matches this query (substring match, optional).<br/><tt>rtype</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_id:</tt></td><td>STRING</td><td>Project ID</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_icon_url:</tt></td><td>STRING</td><td>Project icon URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;relation&#x2F;projects?rtype=route&amp;page=1&amp;rp=10&amp;sortname=project_name&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;relation&#x2F;projects?rtype=route&amp;page=1&amp;rp=10&amp;sortname=project_name&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;relations&#x2F;route#projects" target="_blank">&#x2F;relations&#x2F;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> &mdash; Only return roles which are used in at least this percent of all members (optional).<br/><tt>query</tt> &mdash; Only show results where the role matches this query (substring match, optional).<br/><tt>rtype</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>rtype:</tt></td><td>STRING</td><td>Relation type</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>role:</tt></td><td>STRING</td><td>Relation member role.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all_members:</tt></td><td>INT</td><td>Number of members with this role.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_node_members:</tt></td><td>INT</td><td>Number of members of type node with this role.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_way_members:</tt></td><td>INT</td><td>Number of members of type way with this role.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_relation_members:</tt></td><td>INT</td><td>Number of members of type relation with this role.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;relation&#x2F;roles?rtype=multipolygon&amp;page=1&amp;rp=10" target="_blank">&#x2F;api&#x2F;4&#x2F;relation&#x2F;roles?rtype=multipolygon&amp;page=1&amp;rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;relations&#x2F;multipolygon#roles" target="_blank">&#x2F;relations&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>type:</tt></td><td>STRING</td><td>Member type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;relation&#x2F;stats?rtype=multipolygon" target="_blank">&#x2F;api&#x2F;4&#x2F;relation&#x2F;stats?rtype=multipolygon</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;relations&#x2F;multipolygon#overview" target="_blank">&#x2F;relations&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>language:</tt></td><td>STRING</td><td>Language name in its language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>language_en:</tt></td><td>STRING</td><td>Language name in English.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>title:</tt></td><td>STRING</td><td>Wiki page title.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>dir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Short description of key from wiki page.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>image:</tt></td><td>HASH</td><td>Associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>title:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;relation&#x2F;wiki_pages?rtype=multipolygon" target="_blank">&#x2F;api&#x2F;4&#x2F;relation&#x2F;wiki_pages?rtype=multipolygon</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;relations&#x2F;multipolygon#wiki" target="_blank">&#x2F;relations&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>rtype:</tt></td><td>STRING</td><td>Relation type</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of relations with this type.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>prevalent_roles:</tt></td><td>ARRAY</td><td>Prevalent member roles.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>role:</tt></td><td>STRING</td><td>Member role</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of members with this role.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;relations&#x2F;all?page=1&amp;rp=10" target="_blank">&#x2F;api&#x2F;4&#x2F;relations&#x2F;all?page=1&amp;rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;relations" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;search&#x2F;by_key_and_value?query=highway%3Dresidential&amp;page=1&amp;rp=10" target="_blank">&#x2F;api&#x2F;4&#x2F;search&#x2F;by_key_and_value?query=highway%3Dresidential&amp;page=1&amp;rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;search?q=highway%3Dresidential" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr></table></td> </tr> <tr> <th>Example:</th> <td><a rel="nofollow" href="&#x2F;api&#x2F;4&#x2F;search&#x2F;by_keyword?query=fire&amp;page=1&amp;rp=10" target="_blank">&#x2F;api&#x2F;4&#x2F;search&#x2F;by_keyword?query=fire&amp;page=1&amp;rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;search?q=fire#fulltext" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>rtype:</tt></td><td>STRING</td><td>Relation type.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>role:</tt></td><td>STRING</td><td>Role</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;search&#x2F;by_role?query=foo&amp;page=1&amp;rp=10" target="_blank">&#x2F;api&#x2F;4&#x2F;search&#x2F;by_role?query=foo&amp;page=1&amp;rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;search?q=foo#roles" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;search&#x2F;by_value?query=foo&amp;page=1&amp;rp=10" target="_blank">&#x2F;api&#x2F;4&#x2F;search&#x2F;by_value?query=foo&amp;page=1&amp;rp=10</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;search?q=foo#values" target="_blank">&#x2F;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="&#x2F;api&#x2F;4&#x2F;site&#x2F;config&#x2F;geodistribution" target="_blank">&#x2F;api&#x2F;4&#x2F;site&#x2F;config&#x2F;geodistribution</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="" 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="&#x2F;api&#x2F;4&#x2F;site&#x2F;info" target="_blank">&#x2F;api&#x2F;4&#x2F;site&#x2F;info</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="" 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="&#x2F;api&#x2F;4&#x2F;site&#x2F;sources" target="_blank">&#x2F;api&#x2F;4&#x2F;site&#x2F;sources</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;sources" target="_blank">&#x2F;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> &mdash; Tag key (required).<br/><tt>value</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>date:</tt></td><td>TEXT</td><td>Date in format YYYY-MM-DD.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>nodes:</tt></td><td>INT</td><td>Difference of number of nodes with this tag relative to previous entry.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>ways:</tt></td><td>INT</td><td>Difference of number of ways with this tag relative to previous entry.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;chronology?key=highway&amp;value=primary" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;chronology?key=highway&amp;value=primary</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;highway=primary#chronology" target="_blank">&#x2F;tags&#x2F;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> &mdash; Tag key (required).<br/><tt>query</tt> &mdash; Only show results where the other_key or other_value matches this query (substring match, optional).<br/><tt>value</tt> &mdash; Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> &mdash; No filter.<br/><tt>nodes</tt> &mdash; Only values on tags used on nodes.<br/><tt>relations</tt> &mdash; Only values on tags used on relations.<br/><tt>ways</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>other_key:</tt></td><td>STRING</td><td>Other key.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>other_value:</tt></td><td>STRING</td><td>Other value (may be empty).</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;combinations?key=highway&amp;value=residential&amp;page=1&amp;rp=10&amp;sortname=together_count&amp;sortorder=desc" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;combinations?key=highway&amp;value=residential&amp;page=1&amp;rp=10&amp;sortname=together_count&amp;sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;highway=residential#combinations" target="_blank">&#x2F;tags&#x2F;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> &mdash; Tag key (required).<br/><tt>value</tt> &mdash; 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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;distribution&#x2F;nodes?key=amenity&amp;value=post_box" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;distribution&#x2F;nodes?key=amenity&amp;value=post_box</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;amenity=post_box#map" target="_blank">&#x2F;tags&#x2F;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> &mdash; Tag key (required).<br/><tt>value</tt> &mdash; 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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;distribution&#x2F;ways?key=highway&amp;value=residential" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;distribution&#x2F;ways?key=highway&amp;value=residential</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;highway=residential#map" target="_blank">&#x2F;tags&#x2F;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> &mdash; Tag key (required).<br/><tt>value</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>The tag key that was requested.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>The tag value that was requested.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>projects:</tt></td><td>INT</td><td>Number of projects mentioning this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>english:</tt></td><td>STRING</td><td>English name of this language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>native:</tt></td><td>STRING</td><td>Native name of this language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>dir:</tt></td><td>STRING</td><td>Printing direction for native name ("ltr", "rtl", or "auto")</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>has_map:</tt></td><td>BOOL</td><td>Is a map with the geographical distribution of this tag available?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>counts:</tt></td><td>ARRAY OF HASHES</td><td>Objects counts.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of objects with this type and tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>HASH OF HASHES</td><td>Description of this tag (hash key is language code).</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>text:</tt></td><td>STRING</td><td>Description text.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;overview?key=amenity&amp;value=restaurant" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;overview?key=amenity&amp;value=restaurant</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;amenity=restaurant#overview" target="_blank">&#x2F;tags&#x2F;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> &mdash; Tag key (required).<br/><tt>query</tt> &mdash; Only show results where the project name matches this query (substring match, optional).<br/><tt>value</tt> &mdash; Tag value (required).</td> </tr> <tr> <th>Paging:</th> <td>optional</td> </tr> <tr> <th>Filter:</th> <td><tt>all</tt> &mdash; No filter.<br/><tt>nodes</tt> &mdash; Only values on tags used on nodes.<br/><tt>relations</tt> &mdash; Only values on tags used on relations.<br/><tt>ways</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_id:</tt></td><td>STRING</td><td>Project ID</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_name:</tt></td><td>STRING</td><td>Project name</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>project_icon_url:</tt></td><td>STRING</td><td>Project icon URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_node:</tt></td><td>BOOL</td><td>For nodes?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_way:</tt></td><td>BOOL</td><td>For ways?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_relation:</tt></td><td>BOOL</td><td>For relations?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_area:</tt></td><td>BOOL</td><td>For areas?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Description</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>doc_url:</tt></td><td>STRING</td><td>Documentation URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;projects?key=highway&amp;value=residential&amp;page=1&amp;rp=10&amp;sortname=project_name&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;projects?key=highway&amp;value=residential&amp;page=1&amp;rp=10&amp;sortname=project_name&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;highway=residential#projects" target="_blank">&#x2F;tags&#x2F;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> &mdash; Tag key (required).<br/><tt>value</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>type:</tt></td><td>STRING</td><td>Object type ("all", "nodes", "ways", or "relations")</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count:</tt></td><td>INT</td><td>Number of objects with this type and tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;stats?key=amenity&amp;value=school" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;stats?key=amenity&amp;value=school</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;amenity=school#overview" target="_blank">&#x2F;tags&#x2F;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> &mdash; Tag key (required)<br/><tt>value</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>lang:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>dir:</tt></td><td>STRING</td><td>Writing direction ("ltr", "rtl", or "auto") of description.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>language:</tt></td><td>STRING</td><td>Language name in its language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>language_en:</tt></td><td>STRING</td><td>Language name in English.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>title:</tt></td><td>STRING</td><td>Wiki page title.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Short description of tag from wiki page.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>image:</tt></td><td>HASH</td><td>Associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>title:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_node:</tt></td><td>BOOL</td><td>Is this a tag for nodes?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_way:</tt></td><td>BOOL</td><td>Is this a tag for ways?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_area:</tt></td><td>BOOL</td><td>Is this a tag for areas?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_relation:</tt></td><td>BOOL</td><td>Is this a tag for relations?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>tags_implies:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags implied by this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>tags_linked:</tt></td><td>ARRAY OF STRINGS</td><td>List of keys/tags related to this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tag&#x2F;wiki_pages?key=highway&amp;value=residential" target="_blank">&#x2F;api&#x2F;4&#x2F;tag&#x2F;wiki_pages?key=highway&amp;value=residential</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags&#x2F;highway=residential#wiki" target="_blank">&#x2F;tags&#x2F;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> &mdash; Key (optional)<br/><tt>tags</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>in_wiki:</tt></td><td>BOOL</td><td>In there at least one wiki page for this tag?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_nodes:</tt></td><td>INT</td><td>Number of nodes in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_nodes_fraction:</tt></td><td>FLOAT</td><td>Number of nodes in relation to all tagged nodes.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_ways:</tt></td><td>INT</td><td>Number of ways in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_ways_fraction:</tt></td><td>FLOAT</td><td>Number of ways in relation to all ways.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_relations:</tt></td><td>INT</td><td>Number of relations in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_relations_fraction:</tt></td><td>FLOAT</td><td>Number of relations in relation to all relations.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_node:</tt></td><td>BOOL</td><td>Is this a tag for nodes?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_way:</tt></td><td>BOOL</td><td>Is this a tag for ways?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_area:</tt></td><td>BOOL</td><td>Is this a tag for areas?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>on_relation:</tt></td><td>BOOL</td><td>Is this a tag for relations?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>Description of this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image:</tt></td><td>HASH</td><td>Optional hash with information about descriptive image:</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_suffix:</tt></td><td>STRING</td><td>Suffix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>osmcarto_rendering:</tt></td><td>HASH</td><td>Optional hash with information about default rendering:</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image:</tt></td><td>STRING</td><td>Wiki page title of associated image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>width:</tt></td><td>INT</td><td>Width of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>height:</tt></td><td>INT</td><td>Height of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>mime:</tt></td><td>STRING</td><td>MIME type of image.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>image_url:</tt></td><td>STRING</td><td>Image URL</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<tt>thumb_url_prefix:</tt></td><td>STRING</td><td>Prefix of thumbnail URL.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tags&#x2F;list?tags=highway=primary,secondary,amenity=post_box" target="_blank">&#x2F;api&#x2F;4&#x2F;tags&#x2F;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="" 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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>key:</tt></td><td>STRING</td><td>Key</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>value:</tt></td><td>STRING</td><td>Value</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>in_wiki:</tt></td><td>BOOL</td><td>In there at least one wiki page for this tag?</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all:</tt></td><td>INT</td><td>Number of objects in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_all_fraction:</tt></td><td>FLOAT</td><td>Number of objects in relation to all objects.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_nodes:</tt></td><td>INT</td><td>Number of nodes in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_nodes_fraction:</tt></td><td>FLOAT</td><td>Number of nodes in relation to all tagged nodes.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_ways:</tt></td><td>INT</td><td>Number of ways in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_ways_fraction:</tt></td><td>FLOAT</td><td>Number of ways in relation to all ways.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_relations:</tt></td><td>INT</td><td>Number of relations in the OSM database with this tag.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>count_relations_fraction:</tt></td><td>FLOAT</td><td>Number of relations in relation to all relations.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;tags&#x2F;popular?page=1&amp;rp=10&amp;sortname=tag&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;tags&#x2F;popular?page=1&amp;rp=10&amp;sortname=tag&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;tags" target="_blank">&#x2F;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> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>char:</tt></td><td>TEXT</td><td>Unicode character.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>codepoint:</tt></td><td>INT</td><td>Unicode code point.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>script:</tt></td><td>TEXT</td><td>Code (Xxxx) of script this character is in.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>script_name:</tt></td><td>TEXT</td><td>Name of script this character is in.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>category:</tt></td><td>TEXT</td><td>Unicode general category (Xx) of this character.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;unicode&#x2F;characters?string=highway" target="_blank">&#x2F;api&#x2F;4&#x2F;unicode&#x2F;characters?string=highway</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;keys&#x2F;highway#characters" target="_blank">&#x2F;keys&#x2F;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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>code:</tt></td><td>STRING</td><td>Language code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>dir:</tt></td><td>STRING</td><td>Direction this language is written in ("ltr", "rtl", or "auto").</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>native_name:</tt></td><td>STRING</td><td>Name of language in this language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>english_name:</tt></td><td>STRING</td><td>Name of language in English.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>wiki_key_pages:</tt></td><td>INT</td><td>Number of "Key" wiki pages in this language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>wiki_tag_pages:</tt></td><td>INT</td><td>Number of "Tag" wiki pages in this language.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;wiki&#x2F;languages?sortname=wiki_key_pages&amp;sortorder=desc" target="_blank">&#x2F;api&#x2F;4&#x2F;wiki&#x2F;languages?sortname=wiki_key_pages&amp;sortorder=desc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;reports&#x2F;languages" target="_blank">&#x2F;reports&#x2F;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> &mdash; Language for description (optional, default: 'en').<br/><tt>query</tt> &mdash; 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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>type:</tt></td><td>STRING</td><td>One of 'key', 'tag', or 'relation'.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>item:</tt></td><td>STRING</td><td>The wikidata items Q or P code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>description:</tt></td><td>STRING</td><td>The description of the wikidata item.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<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>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;wikidata&#x2F;all?lang=fr&amp;page=1&amp;rp=10&amp;sortname=item&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;wikidata&#x2F;all?lang=fr&amp;page=1&amp;rp=10&amp;sortname=item&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;sources&#x2F;wikidata&#x2F;items" target="_blank">&#x2F;sources&#x2F;wikidata&#x2F;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>&nbsp;&nbsp;&nbsp;&nbsp;<tt>item:</tt></td><td>STRING</td><td>The wikidata items Q or P code.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>propvalue:</tt></td><td>STRING</td><td>The wikidata item property value.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<tt>desciption:</tt></td><td>STRING</td><td>The description of the wikidata item.</td></tr> <tr><td>&nbsp;&nbsp;&nbsp;&nbsp;<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="&#x2F;api&#x2F;4&#x2F;wikidata&#x2F;errors?page=1&amp;rp=10&amp;sortname=item&amp;sortorder=asc" target="_blank">&#x2F;api&#x2F;4&#x2F;wikidata&#x2F;errors?page=1&amp;rp=10&amp;sortname=item&amp;sortorder=asc</a></td> </tr> <tr> <th title="User interface page where this API is used">UI Example:</th> <td><a href="&#x2F;sources&#x2F;wikidata&#x2F;errors" target="_blank">&#x2F;sources&#x2F;wikidata&#x2F;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> &middot;</span> <a href="//www.openstreetmap.org/copyright">Data &copy; OSM contributors (ODbL)</a></div> <div id="footer_right"> <a href="/download">Download</a> &middot; <a href="/taginfo/apidoc">API</a> &middot; <a id="help-link" target="_blank" href="/help">Help</a> &middot; <a class="extlink" href="//wiki.openstreetmap.org/wiki/Taginfo">Wiki</a> </div> </footer> <div id="javascriptmsg">This website only works with Javascript! Please enable Javascript in your browser.</div> <script>document.getElementById('javascriptmsg').remove();</script> </body> </html>

Pages: 1 2 3 4 5 6 7 8 9 10