aio_taginfo.api.v4.key.distribution.ways

 1"""`/api/4/key/distribution/ways` endpoint."""
 2
 3from aio_taginfo.api.v4 import PngResponse
 4from aio_taginfo.api.v4._internal import NonEmptyString, api_get_png, api_params
 5
 6from aiohttp import ClientSession
 7from pydantic import Field
 8from pydantic.dataclasses import dataclass
 9
10
11__all__ = ("call",)
12
13
14@dataclass(kw_only=True, frozen=True)
15class _Params:
16    key: NonEmptyString = Field(repr=True)
17
18
19async def call(key: str, session: ClientSession | None = None) -> PngResponse:
20    """
21    Get map with distribution of this key in the database (ways only).
22
23    https://taginfo.openstreetmap.org/taginfo/apidoc#api_4_key_distribution_ways
24
25    Args:
26        key: tag key
27        session: request client session
28
29    Raises:
30        TaginfoError
31    """
32    params = api_params(_Params, key=key)
33    return await api_get_png(
34        path="/api/4/key/distribution/ways",
35        session=session,
36        params=params,
37    )
38
39
40__docformat__ = "google"