traveltime python sdk

Tiempo de viaje SDK de Python

Travel Time Python SDK ayuda a los usuarios a encontrar ubicaciones por tiempo de viaje en lugar de utilizar la distancia "en línea recta".
La búsqueda basada en el tiempo brinda a los usuarios más oportunidades de personalización y ofrece una búsqueda más relevante.

Uso

Instalación

Instale Travel Time Python SDK en un virtualenv usando pip . virtualenv es una herramienta para crear entornos Python aislados.

virtualenv permite instalar Travel Time Python SDK sin necesidad de permisos de instalación del sistema y sin entrar en conflicto con las dependencias del sistema instalado.

Linux/Mac

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

ventanas

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

Configuración del SDK

Para autenticarse con Travel Time API, deberá proporcionar el ID de la aplicación y la clave de API.

Acepta:

• app_id: str - ID de aplicación
• api_key: str - Clave API
• limit_per_host: int: número de conexiones simultáneas a un host.
• rate_limit: int - Número de búsquedas que se pueden realizar en una ventana de tiempo.
• time_window: int - Duración, en segundos, del periodo de tiempo en el que limitar la tarifa.
• retry_attempts: int: número de reintentos para solicitudes fallidas.
• host: str - host de TravelTime, el valor predeterminado es api.traveltimeapp.com.
• timeout: int: tiempo máximo de sesión hasta el tiempo de espera. El valor predeterminado es 300 (5 minutos).

 from traveltimepy import TravelTimeSdk

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

Isócronas (mapa del tiempo)

Dadas las coordenadas de origen, encuentre formas de zonas alcanzables dentro del tiempo de viaje correspondiente.

Acepta:

• coordenadas: Lista[Coordenadas] - Coordenadas isócronas.
• llegada_hora: fecha y hora: estar en el lugar de llegada a más tardar a la hora indicada. No se puede especificar con hora_salida.
• salida_hora: fecha y hora: salga del lugar de salida no antes de la hora indicada. No se puede especificar con hora_llegada.
• travel_time: int: tiempo máximo de viaje (en segundos). El valor máximo es 14400. El valor predeterminado es 3600
• transporte: Unión - Modo de transporte y parámetros relacionados.
• search_range: Rango: cuando está habilitado, el rango agrega una ventana de llegada a la hora de llegada y se devuelven resultados para cualquier viaje que llegue durante esta ventana.
• level_of_detail: LevelOfDetail: cuando está habilitado, permite al usuario especificar qué tan detalladas deben ser las isócronas.
• remove_water_bodies: bool - si se establece en verdadero (predeterminado): la forma devuelta no cubrirá grandes cuerpos de agua cercanos. Falso: la forma devuelta puede cubrir cuerpos de agua cercanos como grandes lagos, ríos anchos y mares.
• snapping: Snapping: ajusta el proceso de buscar las carreteras más cercanas desde los puntos de salida/llegada.

respuesta JSON

Devoluciones:

• resultados: Lista[TimeMapResult] - La lista de formas isócronas.

Ejemplo:

 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 ())

respuesta GEOJSON

Devoluciones:

• resultados: FeatureCollection: la lista de funciones.

Ejemplo:

 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 ())

respuesta WKT

Devoluciones:

• resultados: TimeMapWKTResponse - TimeMapWktResponse con formas isócronas.

Ejemplo:

 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 ())

Respuesta WKT_NO_HOLES

Devoluciones:

• resultados: TimeMapWKTResponse - TimeMapWktResponse con formas isócronas (sin agujeros).

Ejemplo:

 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 ())

Isócronas (Intersección)

Dadas las coordenadas de origen, encuentre intersecciones de formas específicas.

Acepta:

• coordenadas: Lista[Coordenadas] - Coordenadas de intersección. El tamaño de la lista no puede ser superior a 10.
• llegada_hora: fecha y hora: estar en el lugar de llegada a más tardar a la hora indicada. No se puede especificar con hora_salida.
• salida_hora: fecha y hora: salga del lugar de salida no antes de la hora indicada. No se puede especificar con hora_llegada.
• travel_time: int: tiempo máximo de viaje (en segundos). El valor máximo es 14400. El valor predeterminado es 3600
• transporte: Unión - Modo de transporte y parámetros relacionados.
• search_range: Rango: cuando está habilitado, el rango agrega una ventana de llegada a la hora de llegada y se devuelven resultados para cualquier viaje que llegue durante esta ventana.
• snapping: Snapping: ajusta el proceso de buscar las carreteras más cercanas desde los puntos de salida/llegada.

Devoluciones:

• resultados: Lista[TimeMapResult] - La lista de formas isócronas.

Ejemplo:

 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 ())

Isócronas (Unión)

Dadas las coordenadas de origen, encuentre uniones de formas específicas.

Encuentra la unión de formas especificadas.

Acepta:

• coordenadas: Lista[Coordenadas] - Coordenadas de unión. El tamaño de la lista no puede ser superior a 10.
• llegada_hora: fecha y hora: estar en el lugar de llegada a más tardar a la hora indicada. No se puede especificar con hora_salida.
• salida_hora: fecha y hora: salga del lugar de salida no antes de la hora indicada. No se puede especificar con hora_llegada.
• travel_time: int: tiempo máximo de viaje (en segundos). El valor máximo es 14400. El valor predeterminado es 3600
• transporte: Unión - Modo de transporte y parámetros relacionados.
• search_range: Rango: cuando está habilitado, el rango agrega una ventana de llegada a la hora de llegada y se devuelven resultados para cualquier viaje que llegue durante esta ventana.
• snapping: Snapping: ajusta el proceso de búsqueda de las carreteras más cercanas desde los puntos de salida/llegada.

Devoluciones:

• resultados: Lista[TimeMapResult] - La lista de formas isócronas.

Ejemplo:

 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 ())

Mapa de tiempo (rápido)

Una versión muy rápida de time_map() . Sin embargo, los parámetros de solicitud son mucho más limitados.

Acepta:

• coordenadas: Lista[Coordenadas] - Coordenadas isócronas.
• [transporte]: Transporte - Modo de transporte y parámetros relacionados.
• travel_time: int: tiempo máximo de viaje (en segundos). El valor máximo es 10800. El valor predeterminado es 3600.
• one_to_many: booleano: devuelve el área accesible para los viajes que llegan al lugar de llegada elegido si es falso, devuelve el área accesible para los viajes que salen del lugar de salida elegido si es verdadero.
• level_of_detail: LevelOfDetail: cuando está habilitado, permite al usuario especificar qué tan detalladas deben ser las isócronas.
• snapping: Snapping: ajusta el proceso de buscar las carreteras más cercanas desde los puntos de salida/llegada.

respuesta JSON

Devoluciones:

• resultados: Lista[TimeMapResult] - La lista de formas isócronas.

Ejemplo:

 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 ())

respuesta GEOJSON

Devoluciones:

• resultados: FeatureCollection: la lista de funciones.

Ejemplo:

 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 ())

respuesta WKT

Devoluciones:

• resultados: TimeMapWKTResponse - TimeMapWktResponse con formas isócronas.

Ejemplo:

 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 ())

Respuesta WKT_NO_HOLES

Devoluciones:

• resultados: TimeMapWKTResponse - TimeMapWktResponse con formas isócronas (sin agujeros).

Ejemplo:

 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 ())

Mapa de distancia

Dadas las coordenadas de origen, encuentre formas de zonas alcanzables dentro de la distancia de viaje correspondiente.

Acepta:

• coordenadas: Lista[Coordenadas] - Coordenadas del lugar de llegada o salida.
• llegada_hora: fecha y hora: estar en el lugar de llegada a más tardar a la hora indicada. No se puede especificar con hora_salida.
• salida_hora: fecha y hora: salga del lugar de salida no antes de la hora indicada. No se puede especificar con hora_llegada.
• travel_distance: int: distancia máxima del viaje (en metros). El valor máximo es 800000 (800 km). El valor mínimo es 75. El valor predeterminado es 900.
• transporte: Unión - Modo de transporte y parámetros relacionados.
• level_of_detail: LevelOfDetail: cuando está habilitado, permite al usuario especificar qué tan detalladas deben ser las isócronas.
• snapping: Snapping: ajusta el proceso de buscar las carreteras más cercanas desde los puntos de salida/llegada.

Devoluciones:

• resultados: List[TimeMapResult] - La lista de formas isócronas

Ejemplo:

 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 ())

Matriz de distancia (filtro de tiempo)

Los puntos de origen y destino dados filtran los puntos a los que no se puede llegar dentro del límite de tiempo especificado. Descubra tiempos de viaje, distancias y costos entre un origen y hasta 2.000 puntos de destino.

Acepta:

• Ubicaciones: Lista[Ubicaciones] - Todas las ubicaciones. Los identificadores de ubicación deben ser únicos.
• search_ids: Dict[str, List[str]] - Identificadores de búsqueda desde una ubicación de destino hasta destinos. Puedes definir hasta 2000 destinos.
• llegada_hora: fecha y hora: estar en el lugar de llegada a más tardar a la hora indicada. No se puede especificar con hora_salida.
• salida_hora: fecha y hora: salga del lugar de salida no antes de la hora indicada. No se puede especificar con hora_llegada.
• transporte: Unión - Modo de transporte y parámetros relacionados.
• travel_time: int: tiempo máximo de viaje (en segundos). El valor máximo es 14400. El valor predeterminado es 3600.
• propiedades: Lista[Propiedad] - Propiedades que se devolverán sobre los puntos. El valor predeterminado es tiempo_viaje.
• rango: FullRange: cuando está habilitado, el rango agrega una ventana de llegada a la hora de llegada y se devuelven resultados para cualquier viaje que llegue durante esta ventana.
• snapping: Snapping: ajusta el proceso de búsqueda de las carreteras más cercanas desde los puntos de salida/llegada.
• snapping: Snapping: ajusta el proceso de buscar las carreteras más cercanas desde los puntos de salida/llegada.

Devoluciones:

• resultados: Lista[TimeFilterResult] - La lista de resultados de ubicaciones accesibles e inalcanzables.

Ejemplo:

 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 ())

Filtro de tiempo (rápido)

Una versión muy rápida de time_filter() . Sin embargo, los parámetros de solicitud son mucho más limitados.

Acepta:

• Ubicaciones: Lista[Ubicaciones] - Todas las ubicaciones. Los identificadores de ubicación deben ser únicos.
• search_ids: Dict[str, List[str]] - Busca desde una ubicación de destino hasta destinos. Puedes definir hasta 100.000 destinos
• [transporte]: Transporte - Modo de transporte y parámetros relacionados.
• travel_time: int: tiempo máximo de viaje (en segundos). El valor máximo es 10800. El valor predeterminado es 3600.
• propiedades: Lista[Propiedad] - Propiedades que se devolverán sobre los puntos. El valor predeterminado es tiempo_viaje.
• one_to_many: booleano: si one_to_many es igual a verdadero, entonces será una búsqueda hacia adelante (matriz de uno a muchos), falsa: búsqueda hacia atrás (matriz de muchos a uno). El valor predeterminado es Verdadero.
• snapping: Snapping: ajusta el proceso de buscar las carreteras más cercanas desde los puntos de salida/llegada.

Devoluciones:

• resultados: Lista[TimeFilterFastResult] - La lista de resultados de ubicaciones accesibles e inalcanzables.

Ejemplo:

 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 ())

Filtro de tiempo rápido (Proto)

Una versión rápida del filtro de tiempo que se comunica mediante buffers de protocolo.

Los parámetros de la solicitud son mucho más limitados y solo se devuelve el tiempo de viaje. Además, los resultados son sólo aproximadamente correctos (se garantiza que el 95% de los resultados estarán dentro del 5% de las rutas devueltas por el filtro de tiempo normal). Esta inflexibilidad viene con el beneficio de tiempos de respuesta más rápidos (más de 5 veces más rápidos en comparación con el filtro de tiempo normal) y límites más grandes en la cantidad de puntos de destino.

Acepta:

• origen: Coordenadas - Punto de origen.
• destinos: Lista[Coordenadas] - Puntos de destino. No puede ser más de 200.000.
• transporte: ProtoTransportation - Tipo de transporte.
• travel_time: int - Límite de tiempo. El valor máximo es 7200.
• país: ProtoCountry: devuelve los resultados que se encuentran dentro del país especificado.
• one_to_many: booleano: si one_to_many es igual a verdadero, entonces será una búsqueda hacia adelante (matriz de uno a muchos), falsa: búsqueda hacia atrás (matriz de muchos a uno). El valor predeterminado es Verdadero.
• propiedades: Lista[PropertyProto] - especifica qué propiedades adicionales deben calcularse en la respuesta.

Devoluciones:

• resultados: TimeFilterProtoResponse: la respuesta contiene:
  • lista de tiempos de viaje, donde cada posición denota un tiempo de viaje (en segundos) de un viaje, o si el tiempo de viaje es negativo, que el viaje desde el origen hasta el punto de destino es imposible.
  • (opcional) lista de distancias donde cada posición indica la distancia (en metros) a la ubicación especificada.

Ejemplo:

 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 ())

Rutas

Devuelve información de enrutamiento entre el origen y los destinos.

Acepta:

• Ubicaciones: Lista[Ubicaciones] - Todas las ubicaciones. Los identificadores de ubicación deben ser únicos.
• search_ids: Dict[str, List[str]] - Busca desde una ubicación de destino hasta destinos.
• llegada_hora: fecha y hora: estar en el lugar de llegada a más tardar a la hora indicada. No se puede especificar con hora_salida.
• salida_hora: fecha y hora: salga del lugar de salida no antes de la hora indicada. No se puede especificar con hora_llegada.
• transporte: Unión - Modo de transporte y parámetros relacionados.
• propiedades: Lista[Propiedad] - Propiedades que se devolverán sobre las ubicaciones. El valor predeterminado es tiempo_viaje.
• rango: FullRange: cuando está habilitado, el rango agrega una ventana de llegada a la hora de llegada y se devuelven resultados para cualquier viaje que llegue durante esta ventana.
• snapping: Snapping: ajusta el proceso de búsqueda de las carreteras más cercanas desde los puntos de salida/llegada.

Devoluciones:

• resultados: Lista[RoutesResult] - La lista de resultados de rutas.

Ejemplo:

 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