หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>หลาม
ดาวน์โหลด

Python SDK เวลาเดินทาง

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
  • หมดเวลา: int - เวลาเซสชันสูงสุดจนกว่าจะหมดเวลา ค่าเริ่มต้นคือ 300 (5 นาที) 
 from traveltimepy import TravelTimeSdk

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

ไอโซโครน (แผนที่เวลา)

เมื่อระบุพิกัดต้นทาง ให้ค้นหารูปร่างของโซนที่สามารถเข้าถึงได้ภายในระยะเวลาการเดินทางที่สอดคล้องกัน

ใช้เวลา:

  • พิกัด: รายการ[พิกัด] - พิกัดไอโซโครน
  • arrival_time: datetime - ให้ถึงสถานที่มาถึงไม่ช้ากว่าเวลาที่กำหนด ไม่สามารถระบุด้วย beginning_time
  • Departure_time: datetime - ออกจากสถานที่ออกเดินทางไม่เร็วกว่าเวลาที่กำหนด ไม่สามารถระบุด้วย arrival_time
  • travel_time: int - เวลาการเดินทางสูงสุด (เป็นวินาที) ค่าสูงสุดคือ 14400 ค่าเริ่มต้นคือ 3600
  • การขนส่ง: ยูเนี่ยน - โหมดการขนส่งและพารามิเตอร์ที่เกี่ยวข้อง
  • search_range: Range - เมื่อเปิดใช้งาน range จะเพิ่มหน้าต่างการมาถึงในเวลาที่มาถึง และผลลัพธ์จะถูกส่งกลับสำหรับการเดินทางใดๆ ที่มาถึงระหว่างหน้าต่างนี้
  • level_of_detail: LevelOfDetail - เมื่อเปิดใช้งาน จะอนุญาตให้ผู้ใช้ระบุรายละเอียดของไอโซโครนที่ควรจะเป็น
  • Remove_water_bodies: bool - หากตั้งค่าเป็นจริง (ค่าเริ่มต้น) - รูปร่างที่ส่งคืนจะไม่ครอบคลุมแหล่งน้ำขนาดใหญ่ในบริเวณใกล้เคียง ปลอม - รูปร่างคืนอาจปกคลุมแหล่งน้ำใกล้เคียง เช่น ทะเลสาบขนาดใหญ่ แม่น้ำกว้างใหญ่ และทะเล
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

การตอบสนองของ JSON

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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 ())

คำตอบของจีโอเจสัน

ผลตอบแทน:

  • ผลลัพธ์: 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: datetime - ให้ถึงสถานที่มาถึงไม่ช้ากว่าเวลาที่กำหนด ไม่สามารถระบุด้วย beginning_time
  • Departure_time: datetime - ออกจากสถานที่ออกเดินทางไม่เร็วกว่าเวลาที่กำหนด ไม่สามารถระบุด้วย arrival_time
  • travel_time: int - เวลาการเดินทางสูงสุด (เป็นวินาที) ค่าสูงสุดคือ 14400 ค่าเริ่มต้นคือ 3600
  • การขนส่ง: ยูเนี่ยน - โหมดการขนส่งและพารามิเตอร์ที่เกี่ยวข้อง
  • search_range: Range - เมื่อเปิดใช้งาน range จะเพิ่มหน้าต่างการมาถึงในเวลาที่มาถึง และผลลัพธ์จะถูกส่งกลับสำหรับการเดินทางใดๆ ที่มาถึงระหว่างหน้าต่างนี้
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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: datetime - ให้ถึงสถานที่มาถึงไม่ช้ากว่าเวลาที่กำหนด ไม่สามารถระบุด้วย beginning_time
  • Departure_time: datetime - ออกจากสถานที่ออกเดินทางไม่เร็วกว่าเวลาที่กำหนด ไม่สามารถระบุด้วย arrival_time
  • travel_time: int - เวลาการเดินทางสูงสุด (เป็นวินาที) ค่าสูงสุดคือ 14400 ค่าเริ่มต้นคือ 3600
  • การขนส่ง: ยูเนี่ยน - โหมดการขนส่งและพารามิเตอร์ที่เกี่ยวข้อง
  • search_range: Range - เมื่อเปิดใช้งาน range จะเพิ่มหน้าต่างการมาถึงในเวลาที่มาถึง และผลลัพธ์จะถูกส่งกลับสำหรับการเดินทางใดๆ ที่มาถึงระหว่างหน้าต่างนี้
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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 - ส่งคืนพื้นที่ที่สามารถเข้าถึงได้สำหรับการเดินทางที่มาถึงตำแหน่งที่มาถึงที่เลือก หากเป็นเท็จ ส่งคืนพื้นที่ที่สามารถเข้าถึงได้สำหรับการเดินทางที่ออกจากสถานที่ออกเดินทางที่เลือก หากเป็นจริง
  • level_of_detail: LevelOfDetail - เมื่อเปิดใช้งาน จะอนุญาตให้ผู้ใช้ระบุรายละเอียดของไอโซโครนที่ควรจะเป็น
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

การตอบสนองของ JSON

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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 ())

คำตอบของจีโอเจสัน

ผลตอบแทน:

  • ผลลัพธ์: 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: datetime - ให้ถึงสถานที่มาถึงไม่ช้ากว่าเวลาที่กำหนด ไม่สามารถระบุด้วย beginning_time
  • Departure_time: datetime - ออกจากสถานที่ออกเดินทางไม่เร็วกว่าเวลาที่กำหนด ไม่สามารถระบุด้วย arrival_time
  • travel_distance: int - ระยะทางการเดินทางสูงสุด (หน่วยเป็นเมตร) ค่าสูงสุดคือ 800000 (800 กม.) ค่าต่ำสุดคือ 75 ค่าเริ่มต้นคือ 900
  • การขนส่ง: ยูเนี่ยน - โหมดการขนส่งและพารามิเตอร์ที่เกี่ยวข้อง
  • level_of_detail: LevelOfDetail - เมื่อเปิดใช้งาน จะอนุญาตให้ผู้ใช้ระบุรายละเอียดของไอโซโครนที่ควรจะเป็น
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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 จุด

ใช้เวลา:

  • สถานที่: รายการ[สถานที่] - สถานที่ทั้งหมด รหัสสถานที่ตั้งต้องไม่ซ้ำกัน
  • search_ids: Dict[str, List[str]] - ค้นหารหัสจากสถานที่เป้าหมายไปยังจุดหมายปลายทาง คุณสามารถกำหนดจุดหมายปลายทางได้มากถึง 2,000 แห่ง
  • arrival_time: datetime - ให้ถึงสถานที่มาถึงไม่ช้ากว่าเวลาที่กำหนด ไม่สามารถระบุด้วย beginning_time
  • Departure_time: datetime - ออกจากสถานที่ออกเดินทางไม่เร็วกว่าเวลาที่กำหนด ไม่สามารถระบุด้วย arrival_time
  • การขนส่ง: ยูเนี่ยน - โหมดการขนส่งและพารามิเตอร์ที่เกี่ยวข้อง
  • travel_time: int - เวลาการเดินทางสูงสุด (เป็นวินาที) ค่าสูงสุดคือ 14400 ค่าเริ่มต้นคือ 3600
  • คุณสมบัติ: รายการ[คุณสมบัติ] - คุณสมบัติที่จะส่งคืนเกี่ยวกับคะแนน ค่าเริ่มต้นคือ travel_time
  • ช่วง: FullRange - เมื่อเปิดใช้งาน ช่วงจะเพิ่มหน้าต่างการมาถึงในเวลาที่มาถึง และผลลัพธ์จะถูกส่งกลับสำหรับการเดินทางใดๆ ที่มาถึงระหว่างหน้าต่างนี้
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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() เวอร์ชันที่รวดเร็วมาก อย่างไรก็ตาม พารามิเตอร์คำขอมีข้อจำกัดมากกว่ามาก

ใช้เวลา:

  • สถานที่: รายการ[สถานที่] - สถานที่ทั้งหมด รหัสสถานที่ตั้งต้องไม่ซ้ำกัน
  • search_ids: Dict[str, List[str]] - ค้นหาจากตำแหน่งเป้าหมายไปยังจุดหมายปลายทาง คุณสามารถกำหนดจุดหมายปลายทางได้มากถึง 100,000 แห่ง
  • [การขนส่ง]: การขนส่ง - โหมดการขนส่งและพารามิเตอร์ที่เกี่ยวข้อง
  • travel_time: int - เวลาการเดินทางสูงสุด (เป็นวินาที) ค่าสูงสุดคือ 10800 ค่าเริ่มต้นคือ 3600
  • คุณสมบัติ: รายการ[คุณสมบัติ] - คุณสมบัติที่จะส่งคืนเกี่ยวกับคะแนน ค่าเริ่มต้นคือ travel_time
  • one_to_many: boolean - หาก one_to_many เท่ากับ true มันจะเป็นการค้นหาไปข้างหน้า (เมทริกซ์หนึ่งต่อหลาย) เท็จ - การค้นหาย้อนหลัง (หลายเมทริกซ์ต่อหนึ่ง) ค่าเริ่มต้นคือ True
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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 มันจะเป็นการค้นหาไปข้างหน้า (เมทริกซ์หนึ่งต่อหลาย) เท็จ - การค้นหาย้อนหลัง (หลายเมทริกซ์ต่อหนึ่ง) ค่าเริ่มต้นคือ 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 ())

เส้นทาง

ส่งคืนข้อมูลเส้นทางระหว่างต้นทางและปลายทาง

ใช้เวลา:

  • สถานที่: รายการ[สถานที่] - สถานที่ทั้งหมด รหัสสถานที่ตั้งต้องไม่ซ้ำกัน
  • search_ids: Dict[str, List[str]] - ค้นหาจากตำแหน่งเป้าหมายไปยังจุดหมายปลายทาง
  • arrival_time: datetime - ให้ถึงสถานที่มาถึงไม่ช้ากว่าเวลาที่กำหนด ไม่สามารถระบุด้วย beginning_time
  • Departure_time: datetime - ออกจากสถานที่ออกเดินทางไม่เร็วกว่าเวลาที่กำหนด ไม่สามารถระบุด้วย arrival_time
  • การขนส่ง: ยูเนี่ยน - โหมดการขนส่งและพารามิเตอร์ที่เกี่ยวข้อง
  • คุณสมบัติ: รายการ[คุณสมบัติ] - คุณสมบัติที่จะส่งคืนเกี่ยวกับสถานที่ตั้ง ค่าเริ่มต้นคือ travel_time
  • ช่วง: FullRange - เมื่อเปิดใช้งาน ช่วงจะเพิ่มหน้าต่างการมาถึงในเวลาที่มาถึง และผลลัพธ์จะถูกส่งกลับสำหรับการเดินทางใดๆ ที่มาถึงระหว่างหน้าต่างนี้
  • การหักมุม: การหักมุม - ปรับกระบวนการค้นหาถนนที่ใกล้ที่สุดจากจุดที่ออกเดินทาง/มาถึง

ผลตอบแทน:

  • ผลลัพธ์: รายการ[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
ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด