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.
`unquote`(string[, encoding, errors])	Replace %xx escapes by their single-character equivalent.

Classes

`ClassGeolocation`(parent, CATALOG_URL)	Методы для работы с геолокацией и выбором магазинов.
`GeolocationSelection`(parent, CATALOG_URL)	Сервис для выбора точек доставки и магазинов.
`Response`(url, status_code, headers, cookies)	Response object
`ShopService`(parent, CATALOG_URL)	Сервис для работы с информацией о магазинах.

class ClassGeolocation(parent, CATALOG_URL: str)[source][source]¶

Bases: object

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

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

Selection¶

Доступ к методам выбора точек доставки и магазинов.

Type:: GeolocationSelection

Shop¶

Доступ к методам работы с магазинами.

Type:: ShopService

current() → Response[source][source]¶: Получить информацию о текущем выбранном городе.

delivery_address() → Response[source][source]¶: Получить настройки адреса доставки.

address_from_position( position: Geoposition, ) → Response[source][source]¶

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

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

suggests( search: str, ) → Response[source][source]¶

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

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

search( search: str, limit: int = 40, ) → Response[source][source]¶

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

Parameters:

search – Название города для поиска
limit – Максимальное количество результатов

class ShopService(parent, CATALOG_URL: str)[source][source]¶

Bases: object

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

all() → Response[source][source]¶: Получить список всех точек магазинов.

info( shop_id: int, ) → Response[source][source]¶

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

Parameters:: shop_id – ID магазина

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, ) → Response[source][source]¶

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

Parameters:

position – Координаты для поиска ближайших магазинов
page – Номер страницы для пагинации
limit – Количество магазинов на странице
city_id – ID города для фильтрации
sort – Сортировка результатов
features – Список особенностей магазина для фильтрации

features() → Response[source][source]¶: Получить список доступных особенностей магазинов для фильтрации.

class GeolocationSelection(parent, CATALOG_URL: str)[source][source]¶

Bases: object

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

shop_point( shop_id: int, ) → Response[source][source]¶

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

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

delivery_point( position: Geoposition, ) → Response[source][source]¶

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

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

delivery_info( position: Geoposition, ) → Response[source][source]¶

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

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