# TmsDataProvider - Тайловый провайдер

class axipy.TmsDataProvider

  Базовые классы: `DataProvider`

  Провайдер для тайловых серверов.

  Примечание

  Ссылку на провайдер можно получить через глобальную переменную `axipy.provider_manager.tms`.

  Свойства:

  `id` | Идентификатор провайдера.

  Методы:

  `create_open`() | Внимание Не поддерживается.
  `file_extensions`() | Список поддерживаемых расширений файлов.
  `get_destination`() | Внимание Не поддерживается.
  `get_source`(templateUrl[, minLevel, ...]) | Создает источник данных.
  `open`(templateUrl[, minLevel, maxLevel, ...]) | Открывает объект данных.

  Специальные методы:

  `__repr__`() | Официальное строковое представление объекта при вызове `repr()`.

  __repr__() → str

    Официальное строковое представление объекта при вызове `repr()`.

  create_open() → NoReturn

    Внимание

    Не поддерживается.

    Исключение:

      NotImplementedError –

  file_extensions() → List[str]

    Список поддерживаемых расширений файлов.

    Результат:

      Пустой список для не файловых провайдеров.

  get_destination() → NoReturn

    Внимание

    Не поддерживается.

    Исключение:

      NotImplementedError –

  get_source(templateUrl: str, minLevel: int = 0, maxLevel: int = 19, size: tuple = (256, 256), type_address: str = 'xyz', watermark: str = '', watermark_style: str = '', prj: Optional[str] = None, live_time: int = 0, alias: Optional[str] = None, maxAttempts: int = 0, noLocalCache: bool = False, extra_data: Optional[WebOpenData] = None) → Source

    Создает источник данных.

    Параметры:

      - templateUrl – Шаблон для запроса данных. Например, https://maps.axioma-gis.ru/osm/{LEVEL}/{ROW}/{COL}.png

      - minLevel – Минимальный уровень показа

      - maxLevel – Максимальный уровень показа

      - size – Размер тайлов

      - type_address – Тип адресации к тайлам. Поддерживается два значения: xyz и quadkey

      - watermark – Ссылка на правообладателя

      - watermark_style – Стиль оформления текста, с которым на карте будут отображаться данные о правообладателе.

      - prj – Строка с Системой Координат. Если None, то используется значение по умолчанию (CoordSys Earth Projection 10, 157, „m“)

      - live_time – время жизни тайла в секундах. Если равно 0, то значение не учитывается.

      - alias – Псевдоним для открываемой таблицы.

      - maxAttempts – Максимальное количество попыток запроса. Значение 0 соответствует значению по умолчанию.

      - noLocalCache – Не использовать локальный кэш

      - extra_data – Дополнительные параметры подключения

  property id: str

    Идентификатор провайдера.

  open(templateUrl: str, minLevel: int = 0, maxLevel: int = 19, size: tuple = (256, 256), type_address: str = 'xyz', watermark: str = '', watermark_style: str = '', prj: Optional[str] = None, live_time: int = 0, alias: Optional[str] = None, maxAttempts: int = 0, noLocalCache: bool = False, extra_data: Optional[WebOpenData] = None) → DataObject

    Открывает объект данных.

    Параметры:

      - templateUrl – Шаблон для запроса данных. Например, https://maps.axioma-gis.ru/osm/{LEVEL}/{ROW}/{COL}.png

      - minLevel – Минимальный уровень показа

      - maxLevel – Максимальный уровень показа

      - size – Размер тайлов

      - type_address – Тип адресации к тайлам. Поддерживается два значения: xyz и quadkey

      - watermark – Ссылка на правообладателя

      - watermark_style – Стиль оформления текста, с которым на карте будут отображаться данные о правообладателе.

      - prj – Строка с Системой Координат. Если None, то используется значение по умолчанию (CoordSys Earth Projection 10, 157, „m“)

      - live_time – время жизни тайла в секундах. Если равно 0, то значение не учитывается.

      - alias – Псевдоним для открываемого источника данных.

      - maxAttempts – Максимальное количество попыток запроса. Значение 0 соответствует значению по умолчанию.

      - noLocalCache – Не использовать локальный кэш

      - extra_data – Дополнительные параметры подключения

    Пример открытия источника:

        prj_mercator = 'CoordSys Earth Projection 10, 104, "m", 0 Bounds (-20037508.34, -20037508.34) (20037508.34, 20037508.34)'
        osm_raster = provider_manager.tms.open('http://maps.axioma-gis.ru/osm/{LEVEL}/{ROW}/{COL}.png', prj=prj_mercator)
        osm_layer = Layer.create(osm_raster)
        map = Map([ osm_layer ])
        view_manager.create_mapview(map)