perekrestok_api.endpoints.geolocation

Геолокация

Functions

quote()

Each part of a URL, e.g. the path info, the query, etc., has a different set of reserved characters that must be quoted.

Classes

ClassGeolocation(parent)

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

FetchResponse(request, page, url, headers, ...)

Represents the response of a request.

GeolocationSelection(parent)

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

ShopService(parent)

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

Bases: object

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

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

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: PerekrestokAPI)[source][source]

Bases: object

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

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: GeolocationPointSort = 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: PerekrestokAPI)[source][source]

Bases: object

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

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 – Координаты для получения информации о доставке