Package: aio-taginfo
A typed async client for thetaginfoAPI, a system for finding and aggregating
information aboutOpenStreetMap'stags, and making it browsable and searchable.This library makes use ofaiohttpfor requests, andPydanticfor parsing
and validating the responses.ContentsRationaleUsageExampleEndpointsSee alsoAn overview of modules, classes and functions can be found in theAPI referenceThe version history is available inCHANGELOG.mdThetaginfo website,
itsAPI documentation,
and itsOSM Wiki pageRationaleOpenStreetMap uses tags to add meaning to geographic objects. There is no fixed
list of those tags. New tags can be invented and used as needed. Everybody can
come up with a new tag and add it to new or existing objects. This makes
OpenStreetMap enormously flexible, but sometimes also a bit hard to work with.Whether you are contributing to OSM or using the OSM data, there are always
questions like: What tags do people use for feature X? What tags can I use for
feature Y so that it appears properly on the map? Is the tag Z described on the
wiki actually in use and where?Taginfo helps you by showing statistics about which tags are actually in the
database, how many people use those tags, where they are used and so on. It also
gets information about tags from the wiki and from other places. Taginfo tries
to bring together all information about tags to help you understand how they are
used and what they mean.Taginfo has an API that lets you access the contents of its databases in several
ways. The API is used internally for the web user interface and can also be used
by anybody who wants to integrate taginfo data into their websites or
applications.UsageThe API is intended for the use of the OpenStreetMap community. Do not use it
for other services. If you are not sure, ask on the mailing list (see below).Always use a sensible User-agent header with enough information that we can
contact you if there is a problem.The server running the taginfo API does not have unlimited resources. Please use
the API responsibly. Do not create huge amounts of requests to get the whole
database or large chunks of it, instead use thedatabase downloadsprovided.
If you are using the API and you find it is slow, you are probably overusing it.If you are using the taginfo API it is recommended that you join thetaginfo-dev mailing list. Updates to the API will be announced there and this
is also the right place for your questions.The data available through taginfo is licenced underODbL,
the same license as the OpenStreetMap data.OpenStreetMap®is open data, licensed under theOpen Data Commons Open Database License(ODbL)
by theOpenStreetMap Foundation(OSMF).You are free to copy, distribute, transmit and adapt our data, as long as you
credit OpenStreetMap and its contributors. If you alter or build upon our data,
you may distribute the result only under the same licence. The fulllegal codeexplains your rights and responsibilities.ExampleHere is an example of an API request using this library:fromaio_taginfoimportkey_overview# either use a temporary session…response:Response[KeyOverview]=awaitkey_overview(key="amenity")# …or provide your ownasyncwithaiohttp.ClientSession()assession:response:Response[KeyOverview]=awaitkey_overview(key="amenity",session=session)EndpointsThis library is early in development and most endpoints are still missing.EndpointSchema/api/4/key/chronologymultiple/api/4/key/combinationspaginated✅/api/4/key/distribution/nodesimage/api/4/key/distribution/waysimage✅/api/4/key/overviewsingle✅/api/4/key/prevalent_valuesmultiple/api/4/key/projectspaginated✅/api/4/key/similarpaginated/api/4/key/statsmultiple/api/4/key/valuespaginated/api/4/key/wiki_pagesmultiple/api/4/keys/allpaginated/api/4/keys/similarpaginated/api/4/keys/wiki_pagespaginated/api/4/keys/without_wiki_pagepaginated/api/4/project/iconimage/api/4/project/tagspaginated/api/4/projects/allpaginated/api/4/projects/keyspaginated/api/4/projects/tagspaginated/api/4/relation/projectspaginated/api/4/relation/rolespaginated/api/4/relation/statsmultiple/api/4/relation/wiki_pagesmultiple/api/4/relations/allpaginated/api/4/search/by_key_and_valuepaginated/api/4/search/by_keywordpaginated/api/4/search/by_rolepaginated/api/4/search/by_valuepaginated✅/api/4/site/config/geodistributionother/api/4/site/infoother/api/4/site/sourcesother/api/4/tag/chronologymultiple/api/4/tag/combinationspaginated/api/4/tag/distribution/nodesimage/api/4/tag/distribution/waysimage/api/4/tag/overviewsingle/api/4/tag/projectspaginated/api/4/tag/statsmultiple/api/4/tag/wiki_pagesmultiple/api/4/tags/listmultiple/api/4/tags/popularpaginated/api/4/unicode/charactersmultiple/api/4/wiki/languagesmultiple