Загрузить traveltime python sdk - Загрузка исходного кода traveltime python sdk

SDK Python для времени в пути

Travel Time Python SDK помогает пользователям находить местоположения по времени в пути, а не по расстоянию «по прямой».
Поиск по времени дает пользователям больше возможностей для персонализации и обеспечивает более релевантный поиск.

Использование

Установка

Установите Travel Time Python SDK в virtualenv с помощью pip . virtualenv — это инструмент для создания изолированных сред Python.

virtualenv позволяет установить Travel Time Python SDK без необходимости разрешения на установку системы и без конфликта с установленными системными зависимостями.

Линукс/Мак

 pip3 install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install traveltimepy

Окна

 pip install virtualenv
virtualenv <your-env>
<your-env>Scriptsactivate
<your-env>Scriptspip.exe install traveltimepy

SDK настроен

Для аутентификации с помощью Travel Time API вам необходимо будет предоставить идентификатор приложения и ключ API.

Берет:

app_id: str — идентификатор приложения
api_key:str — Ключ API
limit_per_host:int — Количество одновременных подключений к одному хосту.
rate_limit: int — количество поисков, которые можно выполнить за временной интервал.
time_window: int — Продолжительность периода времени в секундах, в течение которого ограничивается скорость.
retry_attempts: int — количество повторных попыток неудачных запросов.
хост: str — хост TravelTime, значение по умолчанию — api.traveltimeapp.com.
timeout: int — Максимальное время сеанса до таймаута. Значение по умолчанию — 300 (5 минут).

 from traveltimepy import TravelTimeSdk

sdk = TravelTimeSdk ( app_id = "YOUR_APP_ID" , api_key = "YOUR_APP_KEY" )

Изохроны (карта времени)

По заданным исходным координатам найдите формы зон, достижимых за соответствующее время в пути.

Берет:

координаты: Список[Координаты] - Координаты изохрон.
прибытие_время: дата-время — быть в месте прибытия не позднее заданного времени. Невозможно указать с помощью параметра отправление_время.
вылет_время: дата-время — покинуть место отправления не раньше заданного времени. Невозможно указать с помощью прибытия_времени.
travel_time:int — Максимальное время в пути (в секундах). Максимальное значение — 14400. Значение по умолчанию — 3600.
транспорт: Союз - Вид транспорта и связанные с ним параметры.
search_range: Range — если этот параметр включен, диапазон добавляет окно прибытия ко времени прибытия, и результаты возвращаются для всех поездок, прибывших в течение этого окна.
level_of_detail: LevelOfDetail — если этот параметр включен, позволяет пользователю указать, насколько подробными должны быть изохроны.
Remove_water_bodies: bool — если установлено значение true (по умолчанию) — возвращаемая форма не будет охватывать крупные близлежащие водоемы. Ложь — возвращенная форма может охватывать близлежащие водоемы, такие как большие озера, широкие реки и моря.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

JSON-ответ

Возврат:

результаты: List[TimeMapResult] — список форм изохрон.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Driving , Coordinates , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    results = await sdk . time_map_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        arrival_time = datetime . now (),
        transportation = Driving ()
    )
    print ( results )


asyncio . run ( main ())

Ответ GEOJSON

Возврат:

результаты: FeatureCollection — список функций.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Driving , Coordinates , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    results = await sdk . time_map_geojson_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        arrival_time = datetime . now (),
        transportation = Driving ()
    )
    print ( results )


asyncio . run ( main ())

Ответ ВКТ

Возврат:

результаты: TimeMapWKTResponse — TimeMapWktResponse с изохронными формами.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Driving , Coordinates , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    response = await sdk . time_map_wkt_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        arrival_time = datetime . now (),
        transportation = Driving ()
    )
    response . pretty_print () # for a custom formatted response 
    
    print ( response ) # default Python print

    
asyncio . run ( main ())

Ответ WKT_NO_HOLES

Возврат:

результаты: TimeMapWKTResponse — TimeMapWktResponse с изохронными формами (без дыр).

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Driving , Coordinates , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    response = await sdk . time_map_wkt_no_holes_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        arrival_time = datetime . now (),
        transportation = Driving ()
    )
    response . pretty_print () # for a custom formatted response 

    print ( response ) # default Python print


asyncio . run ( main ())

Изохроны (пересечение)

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

Берет:

координаты: Список[Координаты] - Координаты пересечения. Размер списка не может быть больше 10.
прибытие_время: дата-время — быть в месте прибытия не позднее заданного времени. Невозможно указать с помощью параметра отправление_время.
вылет_время: дата-время — покинуть место отправления не раньше заданного времени. Невозможно указать с помощью прибытия_времени.
travel_time:int — Максимальное время в пути (в секундах). Максимальное значение — 14400. Значение по умолчанию — 3600.
транспорт: Союз - Вид транспорта и связанные с ним параметры.
search_range: Range — если этот параметр включен, диапазон добавляет окно прибытия ко времени прибытия, и результаты возвращаются для всех поездок, прибывших в течение этого окна.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

Возврат:

результаты: List[TimeMapResult] — список форм изохрон.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Driving , Coordinates , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )
    results = await sdk . intersection_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        arrival_time = datetime . now (),
        transportation = Driving ()
    )

    print ( results )


asyncio . run ( main ())

Изохроны (Союз)

Учитывая исходные координаты, найдите объединения указанных фигур.

Находит объединение указанных фигур.

Берет:

координаты: Список[Координаты] - Координаты объединения. Размер списка не может быть больше 10.
прибытие_время: дата-время — быть в месте прибытия не позднее заданного времени. Невозможно указать с помощью параметра отправление_время.
вылет_время: дата-время — покинуть место отправления не раньше заданного времени. Невозможно указать с помощью прибытия_времени.
travel_time:int — Максимальное время в пути (в секундах). Максимальное значение — 14400. Значение по умолчанию — 3600.
транспорт: Союз - Вид транспорта и связанные с ним параметры.
search_range: Range — если этот параметр включен, диапазон добавляет окно прибытия ко времени прибытия, и результаты возвращаются для всех поездок, прибывших в течение этого окна.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

Возврат:

результаты: List[TimeMapResult] — список форм изохрон.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Driving , Coordinates , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )
    results = await sdk . union_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        arrival_time = datetime . now (),
        transportation = Driving ()
    )

    print ( results )


asyncio . run ( main ())

Карта времени (быстро)

Очень быстрая версия time_map() . Однако параметры запроса гораздо более ограничены.

Берет:

координаты: Список[Координаты] - Координаты изохрон.
[транспорт]: Транспортировка — режим транспортировки и связанные с ним параметры.
travel_time:int — Максимальное время в пути (в секундах). Максимальное значение — 10800. Значение по умолчанию — 3600.
one_to_many: boolean — возвращает зону достижимости для поездок, прибывающих в выбранное место прибытия, если false, возвращает зону достижимости для поездок, отправляющихся из выбранного места отправления, если true.
level_of_detail: LevelOfDetail — если этот параметр включен, позволяет пользователю указать, насколько подробными должны быть изохроны.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

JSON-ответ

Возврат:

результаты: List[TimeMapResult] — список форм изохрон.

Пример:

 import asyncio

from traveltimepy import Coordinates , TravelTimeSdk
from traveltimepy . dto . requests . time_map_fast import Transportation

async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    results = await sdk . time_map_fast_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        transportation = Transportation ( type = "driving+ferry" ),
        travel_time = 900
    )

    print ( results )

asyncio . run ( main ())

Ответ GEOJSON

Возврат:

результаты: FeatureCollection — список функций.

Пример:

 import asyncio

from traveltimepy import Coordinates , TravelTimeSdk
from traveltimepy . dto . requests . time_map_fast import Transportation

async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    results = await sdk . time_map_fast_geojson_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        transportation = Transportation ( type = "driving+ferry" ),
        travel_time = 900
    )

    print ( results )

asyncio . run ( main ())

Ответ ВКТ

Возврат:

результаты: TimeMapWKTResponse — TimeMapWktResponse с изохронными формами.

Пример:

 import asyncio

from traveltimepy import Coordinates , TravelTimeSdk
from traveltimepy . dto . requests . time_map_fast import Transportation

async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    results = await sdk . time_map_fast_wkt_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        transportation = Transportation ( type = "driving+ferry" ),
        travel_time = 900
    )

    print ( results )

asyncio . run ( main ())

Ответ WKT_NO_HOLES

Возврат:

результаты: TimeMapWKTResponse — TimeMapWktResponse с изохронными формами (без дыр).

Пример:

 import asyncio

from traveltimepy import Coordinates , TravelTimeSdk
from traveltimepy . dto . requests . time_map_fast import Transportation

async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    results = await sdk . time_map_fast_wkt_no_holes_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        transportation = Transportation ( type = "driving+ferry" ),
        travel_time = 900
    )

    print ( results )

asyncio . run ( main ())

Карта расстояний

Учитывая исходные координаты, найдите формы зон, достижимых на соответствующем расстоянии пути.

Берет:

координаты: Список[Координаты] - Координаты места прибытия или отправления.
прибытие_время: дата-время — быть в месте прибытия не позднее заданного времени. Невозможно указать с помощью параметра отправление_время.
вылет_время: дата-время — покинуть место отправления не раньше заданного времени. Невозможно указать с помощью прибытия_времени.
travel_distance: int — Максимальное расстояние поездки (в метрах). Максимальное значение — 800000 (800км). Минимальное значение — 75. Значение по умолчанию — 900.
транспорт: Союз - Вид транспорта и связанные с ним параметры.
level_of_detail: LevelOfDetail — если этот параметр включен, позволяет пользователю указать, насколько подробными должны быть изохроны.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

Возврат:

результаты: List[TimeMapResult] — список форм изохрон.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Driving , Coordinates , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    results = await sdk . distance_map_async (
        coordinates = [ Coordinates ( lat = 51.507609 , lng = - 0.128315 ), Coordinates ( lat = 51.517609 , lng = - 0.138315 )],
        arrival_time = datetime . now (),
        transportation = Driving ()
    )
    print ( results )


asyncio . run ( main ())

Матрица расстояний (временной фильтр)

Указанные точки отправления и назначения отфильтровывают точки, которые невозможно достичь в течение указанного срока. Узнайте время в пути, расстояния и стоимость между пунктом отправления и до 2000 пунктов назначения.

Берет:

локации: List[Locations] — Все локации. Идентификаторы местоположений должны быть уникальными.
search_ids: Dict[str, List[str]] — идентификаторы поиска от целевого местоположения до пунктов назначения. Вы можете определить до 2000 пунктов назначения.
прибытие_время: дата-время — быть в месте прибытия не позднее заданного времени. Невозможно указать с помощью параметра отправление_время.
вылет_время: дата-время — покинуть место отправления не раньше заданного времени. Невозможно указать с помощью прибытия_времени.
транспорт: Союз - Вид транспорта и связанные с ним параметры.
travel_time:int — Максимальное время в пути (в секундах). Максимальное значение — 14400. Значение по умолчанию — 3600.
свойства: List[Property] — возвращаемые свойства точек. Значение по умолчанию — travel_time.
диапазон: FullRange — если этот параметр включен, диапазон добавляет окно прибытия ко времени прибытия, и результаты возвращаются для всех поездок, прибывших в течение этого окна.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

Возврат:

результаты: List[TimeFilterResult] — список результатов доступных и недоступных местоположений.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Location , Coordinates , PublicTransport , Property , FullRange , TravelTimeSdk


async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )

    locations = [
        Location ( id = "London center" , coords = Coordinates ( lat = 51.508930 , lng = - 0.131387 )),
        Location ( id = "Hyde Park" , coords = Coordinates ( lat = 51.508824 , lng = - 0.167093 )),
        Location ( id = "ZSL London Zoo" , coords = Coordinates ( lat = 51.536067 , lng = - 0.153596 ))
    ]

    results = await sdk . time_filter_async (
        locations = locations ,
        search_ids = {
            "London center" : [ "Hyde Park" , "ZSL London Zoo" ],
            "ZSL London Zoo" : [ "Hyde Park" , "London center" ],
        },
        departure_time = datetime . now (),
        travel_time = 3600 ,
        transportation = PublicTransport ( type = "bus" ),
        properties = [ Property . TRAVEL_TIME ],
        range = FullRange ( enabled = True , max_results = 3 , width = 600 )
    )

    print ( results )


asyncio . run ( main ())

Временной фильтр (быстрый)

Очень быстрая версия time_filter() . Однако параметры запроса гораздо более ограничены.

Берет:

локации: List[Locations] — Все локации. Идентификаторы местоположений должны быть уникальными.
search_ids: Dict[str, List[str]] — поиск от целевого местоположения до пунктов назначения. Вы можете определить до 100 000 пунктов назначения.
[транспорт]: Транспортировка — режим транспортировки и связанные с ним параметры.
travel_time:int — Максимальное время в пути (в секундах). Максимальное значение — 10800. Значение по умолчанию — 3600.
свойства: List[Property] — возвращаемые свойства точек. Значение по умолчанию — travel_time.
one_to_many: boolean — если one_to_many равно true, то это будет прямой поиск (матрица один ко многим), false — обратный поиск (матрица многие к одной). Значение по умолчанию — True.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

Возврат:

результаты: List[TimeFilterFastResult] — список результатов доступных и недоступных местоположений.

Пример:

 import asyncio

from traveltimepy import Location , Coordinates , Transportation , TravelTimeSdk

async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )
    
    locations = [
        Location ( id = "London center" , coords = Coordinates ( lat = 51.508930 , lng = - 0.131387 )),
        Location ( id = "Hyde Park" , coords = Coordinates ( lat = 51.508824 , lng = - 0.167093 )),
        Location ( id = "ZSL London Zoo" , coords = Coordinates ( lat = 51.536067 , lng = - 0.153596 ))
    ]
    
    results = await sdk . time_filter_fast_async (
        locations = locations ,
        search_ids = {
            "London center" : [ "Hyde Park" , "ZSL London Zoo" ],
            "ZSL London Zoo" : [ "Hyde Park" , "London center" ],
        },
        transportation = Transportation ( type = "public_transport" ),
        one_to_many = False
    )
    
    print ( results )
    
asyncio . run ( main ())

Временной фильтр Быстрый (прото)

Быстрая версия временного фильтра, использующая протокольные буферы.

Параметры запроса гораздо более ограничены, и возвращается только время в пути. Кроме того, результаты верны лишь приблизительно (95% результатов гарантированно находятся в пределах 5% маршрутов, возвращаемых обычным временным фильтром). Преимуществом такой негибкости является более быстрое время ответа (более чем в 5 раз быстрее по сравнению с обычным временным фильтром) и более высокие ограничения на количество точек назначения.

Берет:

начало координат: Координаты - Исходная точка.
пункты назначения: Список[Координаты] - Точки назначения. Не может быть больше 200 000.
транспорт: ProtoTransportation - Тип транспорта.
travel_time:int — Ограничение по времени. Максимальное значение — 7200.
страна: ProtoCountry — возвращает результаты, находящиеся в пределах указанной страны.
one_to_many: boolean — если one_to_many равно true, то это будет прямой поиск (матрица один ко многим), false — обратный поиск (матрица многие к одной). Значение по умолчанию — True.
свойства: List[PropertyProto] — указывает, какие дополнительные свойства должны быть рассчитаны в ответе.

Возврат:

результаты: TimeFilterProtoResponse — ответ содержит:
- список времени в пути, где каждая позиция обозначает либо время в пути (в секундах) поездки, либо, если время в пути отрицательное, то путешествие от пункта отправления до пункта назначения невозможно.
- (необязательно) список расстояний, где каждая позиция обозначает расстояние (в метрах) до указанного места.

Пример:

 import asyncio
from traveltimepy import ProtoCountry , Coordinates , ProtoTransportation , TravelTimeSdk , PropertyProto

async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )
    travel_times = await sdk . time_filter_proto_async (
        origin = Coordinates ( lat = 51.425709 , lng = - 0.122061 ),
        destinations = [
            Coordinates ( lat = 51.348605 , lng = - 0.314783 ),
            Coordinates ( lat = 51.337205 , lng = - 0.315793 )
        ],
        transportation = ProtoTransportation . DRIVING_FERRY ,
        travel_time = 7200 ,
        country = ProtoCountry . UNITED_KINGDOM ,
        properties = [ PropertyProto . DISTANCE ],
    )
    
    print ( travel_times )

asyncio . run ( main ())

Маршруты

Возвращает информацию о маршрутизации между источником и пунктами назначения.

Берет:

локации: List[Locations] — Все локации. Идентификаторы местоположений должны быть уникальными.
search_ids: Dict[str, List[str]] — поиск от целевого местоположения до пунктов назначения.
прибытие_время: дата-время — быть в месте прибытия не позднее заданного времени. Невозможно указать с помощью параметра отправление_время.
вылет_время: дата-время — покинуть место отправления не раньше заданного времени. Невозможно указать с помощью прибытия_времени.
транспорт: Союз - Вид транспорта и связанные с ним параметры.
Свойства: List[Property] — возвращаемые свойства местоположений. Значение по умолчанию — travel_time.
диапазон: FullRange — если этот параметр включен, диапазон добавляет окно прибытия ко времени прибытия, и результаты возвращаются для всех поездок, прибывших в течение этого окна.
snapping: Snapping - Регулирует процесс поиска ближайших дорог от точек отправления/прибытия.

Возврат:

результаты: List[RoutesResult] — список результатов маршрутов.

Пример:

 import asyncio
from datetime import datetime

from traveltimepy import Location , Coordinates , PublicTransport , TravelTimeSdk

async def main ():
    sdk = TravelTimeSdk ( "YOUR_APP_ID" , "YOUR_APP_KEY" )
    
    locations = [
        Location ( id = "London center" , coords

Расширять