traveltime python sdk下载 - traveltime python sdk源码下载

旅行时间Python SDK

Travel Time Python SDK 帮助用户通过行程时间而不是使用“直线距离”来查找位置。
基于时间的搜索为用户提供了更多个性化机会并提供更相关的搜索。

用法

安装

使用pip在virtualenv中安装 Travel Time Python SDK。 virtualenv是一个创建隔离的 Python 环境的工具。

virtualenv允许安装 Travel Time Python SDK，无需系统安装权限，也不会与已安装的系统依赖项发生冲突。

Linux/苹果机

 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 进行身份验证，您必须提供应用程序 ID 和 Api 密钥。

需要：

app_id: str - 应用程序 ID
api_key: str - API 密钥
limit_per_host: int - 一台主机的同时连接数。
rate_limit: int - 时间窗口内可以进行的搜索数量。
time_window: int - 限制速率的时间段的持续时间（以秒为单位）。
retry_attempts：int - 失败请求的重试次数。
host: 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" )

等时线（时间图）

给定原点坐标，找到相应行程时间内可到达的区域的形状。

需要：

坐标：列表[坐标] - 等时线坐标。
到达时间：日期时间 - 在不晚于给定时间到达到达地点。不能用出发时间指定。
出发时间：日期时间 - 在不早于给定时间离开出发地点。无法用arrival_time指定。
Travel_time：int - 最大行程时间（以秒为单位）。最大值为 14400。默认值为 3600
运输：联盟-运输方式及相关参数。
search_range：范围 - 启用后，范围会在到达时间上添加一个到达窗口，并返回在此窗口期间到达的任何旅程的结果。
level_of_detail: LevelOfDetail - 启用后，允许用户指定等时线的详细程度。
remove_water_bodies：bool - 如果设置为 true（默认） - 返回的形状将不会覆盖附近的大型水体。错误返回的形状可能会覆盖附近的水体，如大湖、宽阔的河流和海洋。
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 ())

WKT反应

结果：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。
到达时间：日期时间 - 在不晚于给定时间到达到达地点。不能用出发时间指定。
出发时间：日期时间 - 在不早于给定时间离开出发地点。无法用arrival_time指定。
Travel_time：int - 最大行程时间（以秒为单位）。最大值为 14400。默认值为 3600
运输：联盟-运输方式及相关参数。
search_range：范围 - 启用后，范围会在到达时间上添加一个到达窗口，并返回在此窗口期间到达的任何旅程的结果。
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。
到达时间：日期时间 - 在不晚于给定时间到达到达地点。不能用出发时间指定。
出发时间：日期时间 - 在不早于给定时间离开出发地点。无法用arrival_time指定。
Travel_time：int - 最大行程时间（以秒为单位）。最大值为 14400。默认值为 3600
运输：联盟-运输方式及相关参数。
search_range：范围 - 启用后，范围会在到达时间上添加一个到达窗口，并返回在此窗口期间到达的任何旅程的结果。
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：布尔值 - 如果为 false，则返回到达所选到达位置的旅程的可到达区域；如果为 true，则返回从所选出发位置出发的旅程的可到达区域。
level_of_detail: LevelOfDetail - 启用后，允许用户指定等时线的详细程度。
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 ())

WKT反应

结果：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 ())

距离图

给定原点坐标，找到相应行进距离内可到达的区域的形状。

需要：

坐标：列表[坐标] - 到达或出发位置的坐标。
到达时间：日期时间 - 在不晚于给定时间到达到达地点。不能用出发时间指定。
出发时间：日期时间 - 在不早于给定时间离开出发地点。无法用arrival_time指定。
Travel_distance：int - 最大行程距离（以米为单位）。最大值为 800000（800 公里）。最小值为 75。默认值为 900。
运输：联盟-运输方式及相关参数。
level_of_detail: LevelOfDetail - 启用后，允许用户指定等时线的详细程度。
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 ())

距离矩阵（时间滤波器）

给定起点和终点，过滤掉在指定时间内无法到达的点。了解出发地和最多 2,000 个目的地点之间的旅行时间、距离和费用。

需要：

位置：列表[位置] - 所有位置。位置 ID 必须是唯一的。
search_ids: Dict[str, List[str]] - 从目标位置到目的地搜索 ids。您最多可以定义 2000 个目的地
到达时间：日期时间 - 在不晚于给定时间到达到达地点。不能用出发时间指定。
出发时间：日期时间 - 在不早于给定时间离开出发地点。无法用arrival_time指定。
运输：联盟-运输方式及相关参数。
Travel_time：int - 最大行程时间（以秒为单位）。最大值为 14400。默认值为 3600。
属性：List[Property] - 要返回的有关点的属性。默认值为travel_time。
range: FullRange - 启用后，范围会在到达时间上添加一个到达窗口，并返回在此窗口期间到达的任何旅程的结果。
snapping：捕捉 - 调整从出发点/到达点查找最近道路的过程。
snapping：捕捉 - 调整从出发点/到达点查找最近道路的过程。

results: 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()的一个非常快的版本。然而，请求参数受到更多限制。

需要：

位置：列表[位置] - 所有位置。位置 ID 必须是唯一的。
search_ids: Dict[str, List[str]] - 从目标位置搜索到目的地。您最多可以定义 100,000 个目的地
[运输]：运输——运输方式及相关参数。
Travel_time：int - 最大行程时间（以秒为单位）。最大值为 10800。默认值为 3600。
属性：List[Property] - 要返回的有关点的属性。默认值为travel_time。
one_to_many：布尔值 - 如果 one_to_many 等于 true，则它将是向前搜索（一对多矩阵）， false - 向后搜索（多对一矩阵）。默认值为 True。
snapping：捕捉 - 调整从出发点/到达点查找最近道路的过程。

results: 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 倍以上）和对目标点数量的更大限制。

需要：

origin：坐标 - 原点。
目的地：列表[坐标] - 目的地点。不能超过20万。
运输：ProtoTransportation - 运输类型。
Travel_time：int - 时间限制。最大值为 7200。
Country: ProtoCountry - 返回指定国家/地区内的结果。
one_to_many：布尔值 - 如果 one_to_many 等于 true，则它将是向前搜索（一对多矩阵）， false - 向后搜索（多对一矩阵）。默认值为 True。
properties: 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 ())

路线

返回源和目的地之间的路由信息。

需要：

位置：列表[位置] - 所有位置。位置 ID 必须是唯一的。
search_ids: Dict[str, List[str]] - 从目标位置搜索到目的地。
到达时间：日期时间 - 在不晚于给定时间到达到达地点。不能用出发时间指定。
出发时间：日期时间 - 在不早于给定时间离开出发地点。无法用arrival_time指定。
运输：联盟-运输方式及相关参数。
属性：List[Property] - 要返回的有关位置的属性。默认值为travel_time。
range: FullRange - 启用后，范围会在到达时间上添加一个到达窗口，并返回在此窗口期间到达的任何旅程的结果。
snapping：捕捉 - 调整从出发点/到达点查找最近道路的过程。

results: 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

展开

traveltime python sdk

旅行时间Python SDK

用法

安装

Linux/苹果机

视窗

SDK设置

需要：

等时线（时间图）

需要：

JSON 响应

返回：

例子：

GEOJSON 响应

返回：

例子：

WKT反应

返回：

例子：

WKT_NO_HOLES 响应

返回：

例子：

等时线（交点）

需要：

返回：

例子：

等时线（联盟）

需要：

返回：

例子：

时间图（快）

需要：

JSON 响应

返回：

例子：

GEOJSON 响应

返回：

例子：

WKT反应

返回：

例子：

WKT_NO_HOLES 响应

返回：

例子：

距离图

需要：

返回：

例子：

距离矩阵（时间滤波器）

需要：

返回：

例子：

时间过滤器（快速）

需要：

返回：

例子：

快速时间过滤器（原型）

需要：

返回：

例子：

路线

需要：

返回：

例子：