traveltime python sdk

SDK Python pour le temps de trajet

Le SDK Python Travel Time aide les utilisateurs à trouver des emplacements en fonction du temps de trajet plutôt que d'utiliser la distance « à vol d'oiseau ».
La recherche basée sur le temps offre aux utilisateurs plus de possibilités de personnalisation et permet une recherche plus pertinente.

Usage

Installation

Installez le SDK Python Travel Time dans un virtualenv à l'aide de pip . virtualenv est un outil pour créer des environnements Python isolés.

virtualenv permet d'installer le SDK Python Travel Time sans avoir besoin d'autorisations d'installation du système et sans entrer en conflit avec les dépendances du système installées.

Linux/Mac

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

Fenêtres

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

SDK configuré

Afin de vous authentifier auprès de l'API Travel Time, vous devrez fournir l'ID d'application et la clé API.

Prend :

• app_id : str – ID de l'application
• api_key : str - Clé API
• limit_per_host : int - Nombre de connexions simultanées à un hôte.
• rate_limit : int - Nombre de recherches pouvant être effectuées dans une fenêtre de temps.
• time_window : int - Durée, en secondes, de la période pendant laquelle limiter le débit.
• retry_attempts : int - Nombre de tentatives pour les demandes ayant échoué.
• host : str - Hôte TravelTime, la valeur par défaut est api.traveltimeapp.com.
• timeout : int - Durée maximale de la session jusqu'à l'expiration du délai. La valeur par défaut est 300 (5 minutes).

 from traveltimepy import TravelTimeSdk

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

Isochrones (carte temporelle)

Étant donné les coordonnées d'origine, trouvez les formes des zones accessibles dans le temps de trajet correspondant.

Prend :

• coordonnées : Liste[Coordonnées] - Coordonnées isochrones.
• Arrival_time : datetime - Soyez au lieu d'arrivée au plus tard à l'heure indiquée. Ne peut pas être spécifié avec l'heure de départ.
• depart_time : datetime - Quittez le lieu de départ au plus tôt à l'heure indiquée. Ne peut pas être spécifié avec Arrival_time.
• travel_time : int - Durée maximale du trajet (en secondes). La valeur maximale est 14 400. La valeur par défaut est 3 600.
• transport : Union - Mode de transport et paramètres associés.
• search_range : Range - Lorsqu'elle est activée, la plage ajoute une fenêtre d'arrivée à l'heure d'arrivée et les résultats sont renvoyés pour tous les trajets arrivant pendant cette fenêtre.
• level_of_detail : LevelOfDetail - Lorsqu'il est activé, permet à l'utilisateur de spécifier le niveau de détail des isochrones.
• remove_water_bodies : bool - si défini sur true (par défaut) - la forme renvoyée ne couvrira pas les grandes masses d'eau à proximité. La forme faussement renvoyée peut couvrir les plans d'eau à proximité comme les grands lacs, les larges rivières et les mers.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Réponse JSON

Retours :

• résultats : List[TimeMapResult] - La liste des formes isochrones.

Exemple:

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

Réponse GEOJSON

Retours :

• résultats : FeatureCollection - La liste des fonctionnalités.

Exemple:

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

Réponse WKT

Retours :

• résultats : TimeMapWKTResponse - TimeMapWktResponse avec des formes isochrones.

Exemple:

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

Réponse WKT_NO_HOLES

Retours :

• résultats : TimeMapWKTResponse - TimeMapWktResponse avec des formes isochrones (pas de trous).

Exemple:

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

Isochrones (Intersection)

Étant donné les coordonnées d’origine, trouvez les intersections des formes spécifiées.

Prend :

• coordonnées : Liste[Coordonnées] - Coordonnées d'intersection. La taille de la liste ne peut pas dépasser 10.
• Arrival_time : datetime - Soyez au lieu d'arrivée au plus tard à l'heure indiquée. Ne peut pas être spécifié avec l'heure de départ.
• depart_time : datetime - Quittez le lieu de départ au plus tôt à l'heure indiquée. Ne peut pas être spécifié avec Arrival_time.
• travel_time : int - Durée maximale du trajet (en secondes). La valeur maximale est 14 400. La valeur par défaut est 3 600.
• transport : Union - Mode de transport et paramètres associés.
• search_range : Range - Lorsqu'elle est activée, la plage ajoute une fenêtre d'arrivée à l'heure d'arrivée et les résultats sont renvoyés pour tous les trajets arrivant pendant cette fenêtre.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Retours :

• résultats : List[TimeMapResult] - La liste des formes isochrones.

Exemple:

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

Isochrones (Union)

Étant donné les coordonnées d’origine, trouvez les unions de formes spécifiées.

Recherche l'union des formes spécifiées.

Prend :

• coordonnées : Liste[Coordonnées] - Coordonnées de l'union. La taille de la liste ne peut pas dépasser 10.
• Arrival_time : datetime - Soyez au lieu d'arrivée au plus tard à l'heure indiquée. Ne peut pas être spécifié avec l'heure de départ.
• depart_time : datetime - Quittez le lieu de départ au plus tôt à l'heure indiquée. Ne peut pas être spécifié avec Arrival_time.
• travel_time : int - Durée maximale du trajet (en secondes). La valeur maximale est 14 400. La valeur par défaut est 3 600.
• transport : Union - Mode de transport et paramètres associés.
• search_range : Range - Lorsqu'elle est activée, la plage ajoute une fenêtre d'arrivée à l'heure d'arrivée et les résultats sont renvoyés pour tous les trajets arrivant pendant cette fenêtre.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Retours :

• résultats : List[TimeMapResult] - La liste des formes isochrones.

Exemple:

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

Carte temporelle (rapide)

Une version très rapide de time_map() . Cependant, les paramètres de requête sont beaucoup plus limités.

Prend :

• coordonnées : Liste[Coordonnées] - Coordonnées isochrones.
• [transport] : Transport - Mode de transport et paramètres associés.
• travel_time : int - Durée maximale du trajet (en secondes). La valeur maximale est 10 800. La valeur par défaut est 3 600.
• one_to_many : booléen - renvoie la zone accessible pour les trajets arrivant au lieu d'arrivée choisi si faux, renvoie la zone accessible pour les trajets au départ du lieu de départ choisi si vrai.
• level_of_detail : LevelOfDetail - Lorsqu'il est activé, permet à l'utilisateur de spécifier le niveau de détail des isochrones.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Réponse JSON

Retours :

• résultats : List[TimeMapResult] - La liste des formes isochrones.

Exemple:

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

Réponse GEOJSON

Retours :

• résultats : FeatureCollection - La liste des fonctionnalités.

Exemple:

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

Réponse WKT

Retours :

• résultats : TimeMapWKTResponse - TimeMapWktResponse avec des formes isochrones.

Exemple:

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

Réponse WKT_NO_HOLES

Retours :

• résultats : TimeMapWKTResponse - TimeMapWktResponse avec des formes isochrones (pas de trous).

Exemple:

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

Carte des distances

Étant donné les coordonnées d'origine, trouvez les formes des zones accessibles dans la distance de déplacement correspondante.

Prend :

• coordonnées : Liste[Coordonnées] - Coordonnées du lieu d'arrivée ou de départ.
• Arrival_time : datetime - Soyez au lieu d'arrivée au plus tard à l'heure indiquée. Ne peut pas être spécifié avec l'heure de départ.
• depart_time : datetime - Quittez le lieu de départ au plus tôt à l'heure indiquée. Ne peut pas être spécifié avec Arrival_time.
• travel_distance : int - Distance maximale du trajet (en mètres). La valeur maximale est de 800 000 (800 km). La valeur minimale est 75. La valeur par défaut est 900.
• transport : Union - Mode de transport et paramètres associés.
• level_of_detail : LevelOfDetail - Lorsqu'il est activé, permet à l'utilisateur de spécifier le niveau de détail des isochrones.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Retours :

• résultats : List[TimeMapResult] - La liste des formes isochrones

Exemple:

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

Matrice de distance (filtre temporel)

Les points d'origine et de destination donnés filtrent les points qui ne peuvent pas être atteints dans le délai spécifié. Découvrez les temps de trajet, les distances et les coûts entre une origine et jusqu'à 2 000 points de destination.

Prend :

• emplacements : Liste[Emplacements] - Tous les emplacements. Les identifiants de localisation doivent être uniques.
• search_ids : Dict[str, List[str]] - Recherche des identifiants d'un emplacement cible vers des destinations. Vous pouvez définir jusqu'à 2000 destinations
• Arrival_time : datetime - Soyez au lieu d'arrivée au plus tard à l'heure indiquée. Ne peut pas être spécifié avec l'heure de départ.
• depart_time : datetime - Quittez le lieu de départ au plus tôt à l'heure indiquée. Ne peut pas être spécifié avec Arrival_time.
• transport : Union - Mode de transport et paramètres associés.
• travel_time : int - Durée maximale du trajet (en secondes). La valeur maximale est 14 400. La valeur par défaut est 3 600.
• propriétés : List[Property] - Propriétés à renvoyer sur les points. La valeur par défaut est travel_time.
• range: FullRange - Lorsqu'elle est activée, la plage ajoute une fenêtre d'arrivée à l'heure d'arrivée et les résultats sont renvoyés pour tous les trajets arrivant pendant cette fenêtre.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Retours :

• results : List[TimeFilterResult] - La liste des résultats des emplacements accessibles et inaccessibles.

Exemple:

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

Filtre temporel (rapide)

Une version très rapide de time_filter() . Cependant, les paramètres de requête sont beaucoup plus limités.

Prend :

• emplacements : Liste[Emplacements] - Tous les emplacements. Les identifiants de localisation doivent être uniques.
• search_ids : Dict[str, List[str]] - Recherche depuis un emplacement cible vers des destinations. Vous pouvez définir jusqu'à 100 000 destinations
• [transport] : Transport - Mode de transport et paramètres associés.
• travel_time : int - Durée maximale du trajet (en secondes). La valeur maximale est 10 800. La valeur par défaut est 3 600.
• propriétés : List[Property] - Propriétés à renvoyer sur les points. La valeur par défaut est travel_time.
• one_to_many : booléen - si one_to_many est égal à true, alors ce sera une recherche vers l'avant (matrice un vers plusieurs), false - recherche vers l'arrière (matrice plusieurs vers une). La valeur par défaut est True.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Retours :

• résultats : List[TimeFilterFastResult] - La liste des résultats des emplacements accessibles et inaccessibles.

Exemple:

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

Filtre temporel rapide (Proto)

Une version rapide du filtre temporel communiquant à l'aide de tampons de protocole.

Les paramètres de requête sont beaucoup plus limités et seul le temps de trajet est renvoyé. De plus, les résultats ne sont qu'approximativement corrects (95 % des résultats sont garantis à moins de 5 % des itinéraires renvoyés par le filtre temporel régulier). Cette rigidité s'accompagne de l'avantage de temps de réponse plus rapides (plus de 5 fois plus rapides par rapport au filtre temporel normal) et de limites plus larges sur le nombre de points de destination.

Prend :

• origine : Coordonnées - Point d'origine.
• destinations : Liste[Coordonnées] - Points de destination. Ne peut pas dépasser 200 000.
• transport : ProtoTransportation - Type de transport.
• travel_time : int - Limite de temps. La valeur maximale est de 7 200.
• country: ProtoCountry - Renvoie les résultats qui se trouvent dans le pays spécifié.
• one_to_many : booléen - si one_to_many est égal à true, alors ce sera une recherche vers l'avant (matrice un vers plusieurs), false - recherche vers l'arrière (matrice plusieurs vers une). La valeur par défaut est True.
• propriétés : List[PropertyProto] - spécifie quelles propriétés supplémentaires doivent être calculées dans la réponse.

Retours :

• résultats : TimeFilterProtoResponse - La réponse contient :
  • liste des temps de trajet, où chaque position indique soit un temps de trajet (en secondes) d'un trajet, soit si le temps de trajet est négatif, que le trajet de l'origine au point de destination est impossible.
  • (facultatif) liste de distances où chaque position indique la distance (en mètres) jusqu'à l'emplacement spécifié.

Exemple:

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

Itinéraires

Renvoie les informations de routage entre la source et les destinations.

Prend :

• emplacements : Liste[Emplacements] - Tous les emplacements. Les identifiants de localisation doivent être uniques.
• search_ids : Dict[str, List[str]] - Recherche depuis un emplacement cible vers des destinations.
• Arrival_time : datetime - Soyez au lieu d'arrivée au plus tard à l'heure indiquée. Ne peut pas être spécifié avec l'heure de départ.
• depart_time : datetime - Quittez le lieu de départ au plus tôt à l'heure indiquée. Ne peut pas être spécifié avec Arrival_time.
• transport : Union - Mode de transport et paramètres associés.
• propriétés : List[Property] - Propriétés à renvoyer sur les emplacements. La valeur par défaut est travel_time.
• range: FullRange - Lorsqu'elle est activée, la plage ajoute une fenêtre d'arrivée à l'heure d'arrivée et les résultats sont renvoyés pour tous les trajets arrivant pendant cette fenêtre.
• snapping : Snapping - Ajuste le processus de recherche des routes les plus proches des points de départ/d'arrivée.

Retours :

• results : List[RoutesResult] - La liste des résultats des itinéraires.

Exemple:

 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