Инициализация

API может быть использован следующими способами:

  • в приложении ГИС «Аксиома» из панели «Консоль Python»;

  • в модуле, который будет загружен в ГИС «Аксиома»;

  • как SDK - Software development kit, независимо от приложения Аксиома.ГИС.

Примечание

Для использования API в качестве SDK требуется платная лицензия.

В первых двух случаях можно сразу приступать к работе, так как API будет инициализировано за вас. В последнем случае перед началом использования его необходимо самостоятельно инициализировать. Если забыть это сделать, то при попытке использования будет вызвано исключение, которое напомнит выполнить инициализацию.

Например:

from axipy.cs import CoordSystem


try:
    crs = CoordSystem.from_epsg(4326)
except RuntimeError as error:
    print(f"Поймано исключение: {error}")
>>> Поймано исключение: axipy is not initialized

Для инициализации API следует вызвать метод axipy.init_axioma():

from axipy import init_axioma
init_axioma()  # инициализация

from axipy.cs import CoordSystem
crs = CoordSystem.from_epsg(4326)
crs.name
>>> 'Долгота / Широта (WGS 84)'

Допускается (но не рекомендуется) импортировать сразу все классы и функции, чтобы упростить процедуру импорта.

from axipy import *  # импортируем все типы ГИС "Аксиома"
                     # в текущее пространство имен

crs = CoordSystem.from_epsg(4088)
crs.name
>>> 'World Equidistant Cylindrical (Sphere)'