perekrestok_api.endpoints.geolocation

Геолокация

Classes

ClassGeolocation(parent)

Методы для работы с геолокацией и выбором магазинов.

GeolocationSelection(parent)

Сервис для выбора точек доставки и магазинов.

ShopService(parent)

Сервис для работы с информацией о магазинах.
class ClassGeolocation(parent: PerekrestokAPI)[source][source]

Bases: ApiChild[PerekrestokAPI], ApiParent

Методы для работы с геолокацией и выбором магазинов.

Включает получение информации о городах, адресах, поиск магазинов и управление настройками доставки.

Selection: GeolocationSelection

Сервис для выбора точек доставки и магазинов.

Shop: ShopService

Сервис для работы с информацией о магазинах.

async current() → FetchResponse[source][source]

Получить информацию о текущем выбранном городе.

async delivery_address() → FetchResponse[source][source]

Получить настройки адреса доставки.

async address_from_position(
position: Geoposition,
) → FetchResponse[source][source]

Получить адрес по координатам (обратное геокодирование).

Parameters:

position – Объект с координатами

async suggests(
search: str,
) → FetchResponse[source][source]

Получить подсказки адресов по поисковому запросу.

Parameters:

search – Текст для поиска адресов

async search(
search: str,
limit: int = 40,
) → FetchResponse[source][source]

Поиск городов по названию.

Parameters:

  • search – Название города для поиска

  • limit – Максимальное количество результатов

class ShopService(parent: ParentT)[source][source]

Bases: ApiChild[PerekrestokAPI]

Сервис для работы с информацией о магазинах.

async all() → FetchResponse[source][source]

Получить список всех точек магазинов.

async info(
shop_id: int,
) → FetchResponse[source][source]

Получить подробную информацию о магазине.

Parameters:

shop_id – ID магазина

async on_map(
position: Geoposition | None = None,
page: int = 1,
limit: int = 10,
city_id: int | None = None,
sort: dict[str, str] = abstraction.GeolocationPointSort.Distance.ASC,
features: list[int] | None = None,
) → FetchResponse[source][source]

Поиск магазинов на карте с фильтрацией и сортировкой.

Parameters:

  • position – Координаты для поиска ближайших магазинов

  • page – Номер страницы для пагинации

  • limit – Количество магазинов на странице

  • city_id – ID города для фильтрации

  • sort – Сортировка результатов

  • features – Список особенностей магазина для фильтрации

async features() → FetchResponse[source][source]

Получить список доступных особенностей магазинов для фильтрации.

class GeolocationSelection(parent: ParentT)[source][source]

Bases: ApiChild[PerekrestokAPI]

Сервис для выбора точек доставки и магазинов.

async shop_point(
shop_id: int,
) → FetchResponse[source][source]

Выбрать магазин. Изменяет содержимое каталога.

Parameters:

shop_id – ID магазина для установки как точки самовывоза

async delivery_point(
position: Geoposition,
) → FetchResponse[source][source]

Установить точку доставки курьером.

Parameters:

position – Координаты точки доставки

async delivery_info(
position: Geoposition,
) → FetchResponse[source][source]

Получить информацию о доставке для указанных координат.

Parameters:

position – Координаты для получения информации о доставке