traveltime python sdk

Tempo de viagem Python SDK

O Travel Time Python SDK ajuda os usuários a encontrar locais por tempo de viagem, em vez de usar a distância em linha reta.
A pesquisa baseada no tempo oferece aos usuários mais oportunidades de personalização e oferece uma pesquisa mais relevante.

Uso

Instalação

Instale o Travel Time Python SDK em um virtualenv usando pip . virtualenv é uma ferramenta para criar ambientes Python isolados.

virtualenv permite instalar o Travel Time Python SDK sem precisar de permissões de instalação do sistema e sem entrar em conflito com as dependências do sistema instaladas.

Linux/Mac

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

Windows

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

Configuração do SDK

Para autenticar com a API Travel Time, você terá que fornecer o ID do aplicativo e a chave da API.

Leva:

• app_id: str – ID do aplicativo
• api_key: str - Chave da API
• limit_per_host: int – Número de conexões simultâneas com um host.
• rate_limit: int - Número de pesquisas que podem ser feitas em uma janela de tempo.
• time_window: int - Duração, em segundos, do período de tempo no qual limitar a taxa.
• retry_attempts: int – Número de novas tentativas para solicitações com falha.
• host: str - host TravelTime, o valor padrão é api.traveltimeapp.com.
• timeout: int - Tempo máximo da sessão até o tempo limite. O valor padrão é 300 (5 minutos).

 from traveltimepy import TravelTimeSdk

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

Isócronas (Mapa do Tempo)

Dadas as coordenadas de origem, encontre formas de zonas alcançáveis ​​dentro do tempo de viagem correspondente.

Leva:

• coordenadas: Lista[Coordenadas] - Coordenadas isócronas.
• Arrival_time: datetime - Esteja no local de chegada o mais tardar no horário determinado. Não pode ser especificado com partida_time.
• partida_time: datetime - Deixe o local de partida antes do horário determinado. Não pode ser especificado com Arrival_time.
• travel_time: int - Tempo máximo de viagem (em segundos). O valor máximo é 14.400. O valor padrão é 3.600
• transporte: União - Modo de transporte e parâmetros relacionados.
• search_range: Range - Quando ativado, o range adiciona uma janela de chegada ao horário de chegada e os resultados são retornados para todas as viagens que chegam durante essa janela.
• level_of_detail: LevelOfDetail - Quando habilitado, permite ao usuário especificar o quão detalhadas as isócronas devem ser.
• remove_water_bodies: bool - se definido como verdadeiro (padrão) - a forma retornada não cobrirá grandes corpos d'água próximos. A forma falsamente retornada pode cobrir corpos d'água próximos, como grandes lagos, rios largos e mares.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Resposta JSON

Retorna:

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

Exemplo:

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

Resposta GEOJSON

Retorna:

• resultados: FeatureCollection - A lista de recursos.

Exemplo:

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

Resposta WKT

Retorna:

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

Exemplo:

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

Resposta WKT_NO_HOLES

Retorna:

• resultados: TimeMapWKTResponse - TimeMapWktResponse com formas isócronas (sem furos).

Exemplo:

 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 (intersecção)

Dadas as coordenadas de origem, encontre interseções de formas especificadas.

Leva:

• coordenadas: Lista[Coordenadas] - Coordenadas de interseção. O tamanho da lista não pode ser superior a 10.
• Arrival_time: datetime - Esteja no local de chegada o mais tardar no horário determinado. Não pode ser especificado com partida_time.
• partida_time: datetime - Deixe o local de partida antes do horário determinado. Não pode ser especificado com Arrival_time.
• travel_time: int - Tempo máximo de viagem (em segundos). O valor máximo é 14.400. O valor padrão é 3.600
• transporte: União - Modo de transporte e parâmetros relacionados.
• search_range: Range - Quando ativado, o range adiciona uma janela de chegada ao horário de chegada e os resultados são retornados para todas as viagens que chegam durante essa janela.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Retorna:

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

Exemplo:

 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ão)

Dadas as coordenadas de origem, encontre uniões de formas especificadas.

Encontra a união de formas especificadas.

Leva:

• coordenadas: Lista[Coordenadas] - Coordenadas da união. O tamanho da lista não pode ser superior a 10.
• Arrival_time: datetime - Esteja no local de chegada o mais tardar no horário determinado. Não pode ser especificado com partida_time.
• partida_time: datetime - Deixe o local de partida antes do horário determinado. Não pode ser especificado com Arrival_time.
• travel_time: int - Tempo máximo de viagem (em segundos). O valor máximo é 14.400. O valor padrão é 3.600
• transporte: União - Modo de transporte e parâmetros relacionados.
• search_range: Range - Quando ativado, o range adiciona uma janela de chegada ao horário de chegada e os resultados são retornados para todas as viagens que chegam durante essa janela.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Retorna:

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

Exemplo:

 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 tempo (rápido)

Uma versão muito rápida de time_map() . No entanto, os parâmetros de solicitação são muito mais limitados.

Leva:

• coordenadas: Lista[Coordenadas] - Coordenadas isócronas.
• [transporte]: Transporte - Modo de transporte e parâmetros relacionados.
• travel_time: int - Tempo máximo de viagem (em segundos). O valor máximo é 10800. O valor padrão é 3600.
• one_to_many: boolean - retorna a área alcançável para viagens que chegam ao local de chegada escolhido, se for falso, retorna a área acessível para viagens que partem do local de partida escolhido, se for verdadeiro.
• level_of_detail: LevelOfDetail - Quando habilitado, permite ao usuário especificar o quão detalhadas as isócronas devem ser.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Resposta JSON

Retorna:

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

Exemplo:

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

Resposta GEOJSON

Retorna:

• resultados: FeatureCollection - A lista de recursos.

Exemplo:

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

Resposta WKT

Retorna:

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

Exemplo:

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

Resposta WKT_NO_HOLES

Retorna:

• resultados: TimeMapWKTResponse - TimeMapWktResponse com formas isócronas (sem furos).

Exemplo:

 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 distância

Dadas as coordenadas de origem, encontre formas de zonas alcançáveis ​​dentro da distância de viagem correspondente.

Leva:

• coordenadas: Lista[Coordenadas] - Coordenadas do local de chegada ou partida.
• Arrival_time: datetime - Esteja no local de chegada o mais tardar no horário determinado. Não pode ser especificado com partida_time.
• partida_time: datetime - Deixe o local de partida antes do horário determinado. Não pode ser especificado com Arrival_time.
• travel_distance: int – Distância máxima da viagem (em metros). O valor máximo é 800.000 (800km). O valor mínimo é 75. O valor padrão é 900.
• transporte: União - Modo de transporte e parâmetros relacionados.
• level_of_detail: LevelOfDetail - Quando habilitado, permite ao usuário especificar o quão detalhadas as isócronas devem ser.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Retorna:

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

Exemplo:

 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 Distância (Filtro de Tempo)

Os pontos de origem e destino determinados filtram os pontos que não podem ser alcançados dentro do limite de tempo especificado. Descubra tempos de viagem, distâncias e custos entre uma origem e até 2.000 pontos de destino.

Leva:

• locais: Lista[Locais] - Todos os locais. Os IDs de localização devem ser exclusivos.
• search_ids: Dict[str, List[str]] - Pesquisa IDs de um local de destino para destinos. Você pode definir até 2.000 destinos
• Arrival_time: datetime - Esteja no local de chegada o mais tardar no horário determinado. Não pode ser especificado com partida_time.
• partida_time: datetime - Deixe o local de partida antes do horário determinado. Não pode ser especificado com Arrival_time.
• transporte: União - Modo de transporte e parâmetros relacionados.
• travel_time: int - Tempo máximo de viagem (em segundos). O valor máximo é 14400. O valor padrão é 3600.
• propriedades: List[Property] - Propriedades a serem retornadas sobre os pontos. O valor padrão é travel_time.
• intervalo: FullRange - Quando ativado, o intervalo adiciona uma janela de chegada ao horário de chegada e os resultados são retornados para todas as viagens que chegam durante essa janela.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Retorna:

• resultados: List[TimeFilterResult] - A lista de resultados de locais acessíveis e inacessíveis.

Exemplo:

 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 tempo (rápido)

Uma versão muito rápida de time_filter() . No entanto, os parâmetros de solicitação são muito mais limitados.

Leva:

• locais: Lista[Locais] - Todos os locais. Os IDs de localização devem ser exclusivos.
• search_ids: Dict[str, List[str]] - Pesquisa de um local de destino para destinos. Você pode definir até 100.000 destinos
• [transporte]: Transporte - Modo de transporte e parâmetros relacionados.
• travel_time: int - Tempo máximo de viagem (em segundos). O valor máximo é 10800. O valor padrão é 3600.
• propriedades: List[Property] - Propriedades a serem retornadas sobre os pontos. O valor padrão é travel_time.
• one_to_many: boolean - se one_to_many for igual a true, então será uma pesquisa direta (matriz um para muitos), falsa - pesquisa retroativa (muitos para uma matriz). O valor padrão é Verdadeiro.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Retorna:

• resultados: List[TimeFilterFastResult] - A lista de resultados de locais acessíveis e inacessíveis.

Exemplo:

 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 tempo rápido (Proto)

Uma versão rápida de comunicação de filtro de tempo usando buffers de protocolo.

Os parâmetros da solicitação são muito mais limitados e apenas o tempo de viagem é retornado. Além disso, os resultados são apenas aproximadamente corretos (é garantido que 95% dos resultados estejam dentro de 5% das rotas retornadas pelo filtro de tempo regular). Essa inflexibilidade traz o benefício de tempos de resposta mais rápidos (mais de 5x mais rápidos em comparação com o filtro de tempo normal) e limites maiores na quantidade de pontos de destino.

Leva:

• origem: Coordenadas - Ponto de origem.
• destinos: Lista[Coordenadas] - Pontos de destino. Não pode ser superior a 200.000.
• transporte: ProtoTransportation - Tipo de transporte.
• travel_time: int - Limite de tempo. O valor máximo é 7200.
• país: ProtoCountry - Retorna os resultados que estão dentro do país especificado.
• one_to_many: boolean - se one_to_many for igual a true, então será uma pesquisa direta (matriz um para muitos), falsa - pesquisa retroativa (muitos para uma matriz). O valor padrão é Verdadeiro.
• propriedades: List[PropertyProto] - especifica quais propriedades extras devem ser calculadas na resposta.

Retorna:

• resultados: TimeFilterProtoResponse – A resposta contém:
  • lista de tempos de viagem, onde cada posição indica o tempo de viagem (em segundos) de uma viagem ou, se o tempo de viagem for negativo, que a viagem da origem ao ponto de destino é impossível.
  • (opcional) lista de distâncias onde cada posição indica a distância (em metros) até o local especificado.

Exemplo:

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

Rotas

Retorna informações de roteamento entre origem e destino.

Leva:

• locais: Lista[Locais] - Todos os locais. Os IDs de localização devem ser exclusivos.
• search_ids: Dict[str, List[str]] - Pesquisa de um local de destino para destinos.
• Arrival_time: datetime - Esteja no local de chegada o mais tardar no horário determinado. Não pode ser especificado com partida_time.
• partida_time: datetime - Deixe o local de partida antes do horário determinado. Não pode ser especificado com Arrival_time.
• transporte: União - Modo de transporte e parâmetros relacionados.
• propriedades: List[Property] - Propriedades a serem retornadas sobre os locais. O valor padrão é travel_time.
• intervalo: FullRange - Quando ativado, o intervalo adiciona uma janela de chegada ao horário de chegada e os resultados são retornados para todas as viagens que chegam durante essa janela.
• snapping: Snapping - Ajusta o processo de busca das estradas mais próximas dos pontos de partida/chegada.

Retorna:

• resultados: List[RoutesResult] - A lista de resultados de rotas.

Exemplo:

 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