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。
運輸：聯盟-運輸方式及相關參數。
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。
運輸：聯盟-運輸方式及相關參數。
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。
運輸：聯盟-運輸方式及相關參數。
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。
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。
運輸：聯盟-運輸方式及相關參數。
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。
屬性：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。
屬性：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 回應

返回：

例子：

距離圖

需要：

返回：

例子：

距離矩陣（時間濾波器）

需要：

返回：

例子：

時間過濾器（快速）

需要：

返回：

例子：

快速時間過濾器（原型）

需要：

返回：

例子：

路線

需要：

返回：

例子：