# O glossário de mobilidade e dados. Definições simples para entender transportes, serviços de proximidade e as ferramentas que os conectam às suas aplicações. Source: https://www.roote.ai/pt/glossario-mobilidade/ Language: pt Author: ROOTE ## Bicicleta de uso compartilhado Serviço que permite pegar uma bicicleta para uso temporário, conforme condições do operador. Pode funcionar com estações ou veículos sem estação. Exemplo : Você localiza uma bicicleta e usa o serviço de aluguel correspondente. Aprofundar no guia : [Como encontrar uma bicicleta de uso livre perto de si?](https://www.roote.ai/pt/guides/como-encontrar-uma-bicicleta-de-uso-livre-perto-de-si/) ## Mobilidade compartilhada Conjunto de serviços que oferecem acesso a veículos usados sucessivamente por várias pessoas, em vez de um veículo reservado a um único proprietário. Exemplo : Bicicletas e patinetes disponíveis para aluguel em uma cidade. Aprofundar no guia : [Como encontrar uma bicicleta de uso livre perto de si?](https://www.roote.ai/pt/guides/como-encontrar-uma-bicicleta-de-uso-livre-perto-de-si/) ## Estação de ancoragem Equipamento em uma estação onde uma bicicleta pode ser presa. Sua presença não garante que aceite devoluções no momento consultado. Exemplo : Deve haver um espaço de devolução disponível e utilizável. Aprofundar no guia : [Estação de bicicletas vazia ou cheia: o que fazer?](https://www.roote.ai/pt/guides/estacao-de-bicicletas-vazia-ou-cheia-o-que-fazer/) ## Estação de bicicletas Local organizado para pegar ou devolver bicicletas compartilhadas. Coordenadas, capacidades e disponibilidades descrevem aspectos diferentes da estação. Exemplo : Uma estação pode estar no mapa e temporariamente vazia. Aprofundar no guia : [Estação de bicicletas vazia ou cheia: o que fazer?](https://www.roote.ai/pt/guides/estacao-de-bicicletas-vazia-ou-cheia-o-que-fazer/) ## Sem estação — free-floating Organização na qual veículos não precisam ser retirados e devolvidos em estações fixas. Zonas e regras de estacionamento seguem as do serviço. Exemplo : Um patinete deve ser devolvido em uma área autorizada. Aprofundar no guia : [Bicicleta com estação ou sem estação: quais diferenças?](https://www.roote.ai/pt/guides/bicicleta-com-estacao-ou-sem-estacao-quais-diferencas/) ## Disponibilidade Estado ou quantidade que indica o que pode ser usado segundo as informações conhecidas. Uma disponibilidade observada pode mudar e não é reserva. Exemplo : Três bicicletas observadas numa estação não equivalem a três reservas. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Retirada de veículo Ação de começar a usar um veículo. Um contador positivo não é suficiente se o serviço informa que retirada está desativada. Exemplo : Bicicletas estão presentes, mas a estação pode não permitir aluguel. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Devolução Fim do uso de um veículo segundo as regras do serviço. Possibilidades de devolução podem ser diferentes das de retirada. Exemplo : Uma estação permite saída, mas não possui vaga para devolução. Aprofundar no guia : [Estação de bicicletas vazia ou cheia: o que fazer?](https://www.roote.ai/pt/guides/estacao-de-bicicletas-vazia-ou-cheia-o-que-fazer/) ## Bicicleta com assistência elétrica Bicicleta cujo motor auxilia o pedal conforme características. Dados podem indicar propulsão e bateria separadamente. Exemplo : Uma estação pode distinguir bicicletas mecânicas e elétricas. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Intermodalidade Uso sucessivo de vários modos de transporte em um trajeto. Cada etapa mantém seus horários, acessos e condições. Exemplo : Você vai de bicicleta ao tram e depois segue a pé. Aprofundar no guia : [Como combinar bicicleta e transporte público no dia a dia?](https://www.roote.ai/pt/guides/como-combinar-bicicleta-e-transporte-publico-no-dia-a-dia/) ## Parada de transporte Local onde serviço de transporte pega ou deixa passageiros. Uma parada descoberta não informa automaticamente próximos horários. Exemplo : Parada de ônibus retornada sem horário de partida. Aprofundar no guia : [Como encontrar o ponto de ônibus ou tram mais próximo?](https://www.roote.ai/pt/guides/como-encontrar-o-ponto-de-onibus-ou-tram-mais-proximo/) ## Plataforma (quai) Espaço ou ponto de embarque em local de transporte. Várias plataformas próximas podem atender direções ou serviços diferentes. Exemplo : Sentidos opostos da linha podem usar plataformas distintas. Aprofundar no guia : [Como encontrar a parada de ônibus certa e a direção correta?](https://www.roote.ai/pt/guides/como-encontrar-a-parada-de-onibus-certa-e-a-direcao-correta/) ## Linha Serviço de transporte identificado na rede, com um ou mais trajetos ou variantes. Nome da linha não determina sentido correto. Exemplo : Linha pode ter vários terminais. Aprofundar no guia : [Como encontrar a parada de ônibus certa e a direção correta?](https://www.roote.ai/pt/guides/como-encontrar-a-parada-de-onibus-certa-e-a-direcao-correta/) ## Viagem Execução de serviço de transporte associada a trajeto e paradas. Em GTFS, viagem está ligada a linha e calendário de serviço. Exemplo : Duas partidas consecutivas da mesma linha são duas viagens. Aprofundar no guia : [GTFS, GTFS-RT e GBFS: quais as diferenças?](https://www.roote.ai/pt/guides/gtfs-gtfs-rt-e-gbfs-quais-diferencas/) ## Sentido Indicação da direção ou destino do serviço. Deve ser verificada com trajeto e ponto de embarque. Exemplo : Você procura o tram para seu destino, não sentido oposto. Aprofundar no guia : [Como encontrar a parada de ônibus certa e a direção correta?](https://www.roote.ai/pt/guides/como-encontrar-a-parada-de-onibus-certa-e-a-direcao-correta/) ## Terminal Extremidade de trajeto de transporte. Linha pode ter variantes com terminais diferentes. Exemplo : Serviço curto termina antes do terminal usual. Aprofundar no guia : [Como encontrar a parada de ônibus certa e a direção correta?](https://www.roote.ai/pt/guides/como-encontrar-a-parada-de-onibus-certa-e-a-direcao-correta/) ## Conexão Troca de serviço ou modo durante trajeto. Proximidade de duas paradas não garante conexão viável. Exemplo : É preciso prever deslocamento entre plataformas e espera. Aprofundar no guia : [Como ler um mapa de ônibus, bonde ou metrô?](https://www.roote.ai/pt/guides/como-ler-um-mapa-de-onibus-de-tram-ou-metro/) ## Hora programada Hora prevista no plano de serviço para data e passagem. Não reflete necessariamente a situação atual do veículo. Exemplo : Partida programada para 8h10 no calendário. Aprofundar no guia : [Horários de ônibus: qual a diferença entre horários teóricos e em tempo real?](https://www.roote.ai/pt/guides/horarios-de-onibus-diferenca-entre-horarios-teoricos-e-tempo-real/) ## Hora estimada Previsão futura calculada com base em informações disponíveis. Pode mudar com novos dados. Exemplo : Passagem prevista para 8h10 estimada agora para 8h14. Aprofundar no guia : [Horários de ônibus: qual a diferença entre horários teóricos e em tempo real?](https://www.roote.ai/pt/guides/horarios-de-onibus-diferenca-entre-horarios-teoricos-e-tempo-real/) ## Próxima partida Próximo passageiro ou partida retornado para local e serviço. Encontrar parada não equivale a buscar próximas partidas. Exemplo : Listas de paradas e partidas são resultados distintos. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Interrupção Evento que afeta serviço, como interrupção ou modificação de trajeto. Efeitos devem ser entendidos dentro do perímetro e período informados. Exemplo : Alerta pode afetar linha só em certas horas. Aprofundar no guia : [Como criar um assistente que encontra as mobilidades ao redor de um endereço?](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/) ## Calendário de serviço Informações que descrevem dias em que serviço está previsto, com exceções possíveis. Horários interpretados junto com este calendário. Exemplo : Passagem na semana pode não acontecer no domingo. Aprofundar no guia : [GTFS, GTFS-RT e GBFS: quais as diferenças?](https://www.roote.ai/pt/guides/gtfs-gtfs-rt-e-gbfs-quais-diferencas/) ## Serviço urbano Equipamento ou serviço útil próximo a local, ex.: banheiros, ponto de água ou estação de recarga. Atributos podem estar incompletos. Exemplo : Resultado de proximidade descreve serviço e informações conhecidas. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Banheiros públicos Banheiros destinados ao uso público conforme condições locais. Presença em dados não garante gratuidade, abertura ou acessibilidade atual. Exemplo : Verifique condições antes de ir até o local. Aprofundar no guia : [Como encontrar toaletes públicas gratuitas ao seu redor?](https://www.roote.ai/pt/guides/como-encontrar-toaletes-publicas-gratuitas-ao-seu-redor/) ## Acessibilidade Características que permitem uso de local ou serviço conforme necessidades da pessoa. Dado desconhecido não significa acessível nem inacessível. Exemplo : Acessibilidade para cadeirantes pode estar informada ou desconhecida. Aprofundar no guia : [Banheiros públicos acessíveis: o que verificar antes de se deslocar?](https://www.roote.ai/pt/guides/banheiros-publicos-acessiveis-o-que-verificar-antes-de-se-deslocar/) ## Pessoa com mobilidade reduzida — PMR Pessoa com dificuldade de locomoção temporária ou permanente. Menção PMR não detalha todos acessos ou equipamentos necessários. Exemplo : Rampa não descreve todos os obstáculos possíveis. Aprofundar no guia : [Banheiros públicos acessíveis: o que verificar antes de se deslocar?](https://www.roote.ai/pt/guides/banheiros-publicos-acessiveis-o-que-verificar-antes-de-se-deslocar/) ## Horário de funcionamento Período em que local anuncia estar aberto. Não confirma funcionamento em tempo real. Exemplo : Fechamento temporário pode não constar no horário usual. Aprofundar no guia : [Como encontrar toaletes públicas gratuitas ao seu redor?](https://www.roote.ai/pt/guides/como-encontrar-toaletes-publicas-gratuitas-ao-seu-redor/) ## Água potável Água indicada para consumo humano. Ponto de água não deve ser indicado como potável sem informação explícita. Exemplo : Diferenciar tipo de equipamento e seus atributos. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Estação de recarga Equipamento para recarregar veículo compatível. Localizar estação não garante disponibilidade ou compatibilidade do conector. Exemplo : Local de recarga e seu estado são informações distintas. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Tipo de serviço Categoria usada para selecionar ou descrever serviço urbano. Valores aceitos dependem da interface e esquema. Exemplo : API Serviços ROOTE usa types=toilets para banheiros. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Geolocalização Obtenção da posição geográfica por aparelho ou app. Depende de permissões e precisão disponíveis. Exemplo : Botão de localização pede permissão do navegador. Aprofundar no guia : [Como integrar um mapa de mobilidade no seu site?](https://www.roote.ai/pt/guides/como-integrar-um-mapa-de-mobilidade-no-seu-site/) ## Coordenadas GPS Valores que representam ponto geográfico, geralmente latitude e longitude. Ordem deve ser especificada na interface. Exemplo : Pesquisa de proximidade recebe duas coordenadas distintas. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Latitude Coordenada que indica posição norte ou sul do equador, em graus. Valores válidos vão de −90 a 90. Exemplo : Latitude do ponto de busca é enviada em lat. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Longitude Coordenada que indica posição leste-oeste em relação ao meridiano de referência. Valores vão de −180 a 180. Exemplo : Longitude pode ser enviada como lon ou alias documentado lng. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Geocodificação Busca que transforma endereço ou expressão geográfica em candidatos com coordenadas. Vários locais podem corresponder à mesma entrada. Exemplo : Duas cidades possuem rua com mesmo nome. Aprofundar no guia : [Como criar um assistente que encontra as mobilidades ao redor de um endereço?](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/) ## Geocodificação reversa Busca de locais ou nomes a partir de coordenadas. Resultado pode representar local próximo, não endereço exato garantido. Exemplo : Ponto GPS é associado a nome legível. Aprofundar no guia : [O que é um servidor MCP e para que serve?](https://www.roote.ai/pt/guides/o-que-e-um-servidor-mcp-e-para-que-serve/) ## Ponto de interesse — POI Local útil e identificável para busca, como estabelecimento ou equipamento. POI difere de endereço postal simples. Exemplo : Nome de hotel pode ser buscado como estabelecimento. Aprofundar no guia : [Como criar um assistente que encontra as mobilidades ao redor de um endereço?](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/) ## Origem da busca Ponto de onde é feita busca de proximidade e cálculo de distâncias. Pode diferir do centro mostrado no mapa. Exemplo : Câmera move, busca permanece centrada em Bordeaux. Aprofundar no guia : [Como integrar um mapa de mobilidade no seu site?](https://www.roote.ai/pt/guides/como-integrar-um-mapa-de-mobilidade-no-seu-site/) ## Raio de busca Distância em volta do ponto de origem usada para delimitar busca. Unidade e limites dependem do contrato da rota ou ferramenta. Exemplo : radius=600 pede raio de 600 metros no exemplo REST. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Distância geográfica Distância calculada entre posições segundo método do serviço. Não é automaticamente distância de rota nem tempo a pé. Exemplo : Local próximo pode exigir desvio para acessar. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Zoom do mapa Nível de aproximação da visão cartográfica. Controla exibição e não substitui raio de consulta API. Exemplo : zoom=15 aproxima visão do mapa. Aprofundar no guia : [Como integrar um mapa de mobilidade no seu site?](https://www.roote.ai/pt/guides/como-integrar-um-mapa-de-mobilidade-no-seu-site/) ## Dados em tempo real Informações atualizadas para representar situação recente ou alimentar estimativa. Frescor deve ser avaliado; tempo real não significa instantâneo nem garantido. Exemplo : Estimativa de passagem recalculada a partir de dados recentes. Aprofundar no guia : [Horários de ônibus: qual a diferença entre horários teóricos e em tempo real?](https://www.roote.ai/pt/guides/horarios-de-onibus-diferenca-entre-horarios-teoricos-e-tempo-real/) ## Observação Estado ou evento constatado num instante identificado. Deve ser distinguido de evento previsto ou estimado. Exemplo : Passagem real de ônibus pode diferir da estimativa. Aprofundar no guia : [Horários de ônibus: qual a diferença entre horários teóricos e em tempo real?](https://www.roote.ai/pt/guides/horarios-de-onibus-diferenca-entre-horarios-teoricos-e-tempo-real/) ## Frescura dos dados Qualificação da atualidade da informação, segundo datas e regras do contrato. Hora da consulta não prova frescura da fonte. Exemplo : Contador recebido agora pode vir de observação antiga. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Timestamp (carimbo de data/hora) Indicação temporal associada a dado ou evento. Significado depende do campo: observação, atualização, recebimento ou expiração. Exemplo : source_updated_at e received_at indicam etapas distintas. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Dado expirado — stale Informação considerada muito antiga segundo contrato ou política de validade. Pode ser mantida como histórico recente, sem se apresentar como fresca. Exemplo : Interface indica que disponibilidade deve ser atualizada. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Tempo de vida (TTL) Duração usada para gerenciar validade ou renovação de dado em cache, conforme contrato. Não prova por si só hora da observação fonte. Exemplo : Cache expirado deve seguir política de atualização. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Cache Armazenamento temporário de resultados para evitar buscas repetidas idênticas. Valor em cache mantém origem e contexto temporal. Exemplo : Duas solicitações iguais podem reutilizar resposta válida. Aprofundar no guia : [Disponibilidade de bicicletas em tempo real: como exibir em um aplicativo?](https://www.roote.ai/pt/guides/disponibilidade-bicicletas-tempo-real-exibicao-aplicacao/) ## Cobertura Perímetro e grau de completude das informações em busca ou fonte. Cobertura parcial limita conclusões possíveis. Exemplo : Lista pode ser útil sem representar todos os serviços existentes. Aprofundar no guia : [Nenhum resultado ou erro API: como fazer a distinção?](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/) ## Proveniência Informações que identificam origem de dado e, conforme contrato, como foi produzido. Ajudam a interpretar seu alcance. Exemplo : Resultado mantém fonte e contexto de coleta. Aprofundar no guia : [Como criar um assistente que encontra as mobilidades ao redor de um endereço?](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/) ## Atribuição Menção ao fornecedor ou fonte associada a dado. Quando requerida, aplicação deve exibir essa atribuição. Exemplo : Atribuição required=true deve ser mostrada na interface. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## GTFS Schedule Formato padrão para descrever oferta planejada de transporte: paradas, linhas, viagens, calendários e horários. Não fornece atualizações em tempo real automaticamente. Exemplo : Passagens planejadas ligadas a viagens e dias de serviço. Aprofundar no guia : [GTFS, GTFS-RT e GBFS: quais as diferenças?](https://www.roote.ai/pt/guides/gtfs-gtfs-rt-e-gbfs-quais-diferencas/) ## GTFS Realtime — GTFS-RT Formato padrão para transmitir atualizações de viagens, posições de veículos e alertas. Categorias publicadas dependem do produtor. Exemplo : Fluxo de posições não implica estimativas para todas as paradas. Aprofundar no guia : [GTFS, GTFS-RT e GBFS: quais as diferenças?](https://www.roote.ai/pt/guides/gtfs-gtfs-rt-e-gbfs-quais-diferencas/) ## GBFS Formato padrão de dados públicos para mobilidade compartilhada. Depende da versão e fluxos, descreve sistemas, estações, veículos e seus estados. Exemplo : Informações de estação e contadores de disponibilidade são separados. Aprofundar no guia : [GTFS, GTFS-RT e GBFS: quais as diferenças?](https://www.roote.ai/pt/guides/gtfs-gtfs-rt-e-gbfs-quais-diferencas/) ## Valor desconhecido — null Ausência de valor conhecido num contrato que usa null para isso. Não deve ser substituído por zero, falso ou indicação de ausência. Exemplo : Contador de bicicletas null não indica estação vazia. Aprofundar no guia : [Nenhum resultado ou erro API: como fazer a distinção?](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/) ## API Interface que permite a um programa usar capacidades de outro serviço por contrato definido. Especifica entradas e respostas esperadas. Exemplo : Aplicativo busca paradas com API ROOTE. Aprofundar no guia : [API ou MCP: qual escolher para integrar dados de mobilidade?](https://www.roote.ai/pt/guides/api-ou-mcp-qual-escolher-para-integrar-dados-de-mobilidade/) ## API REST Abordagem HTTP que usa recursos e mecanismos web. Contrato de API define rotas, métodos e representações. Exemplo : Busca é enviada a rota GET documentada. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Endpoint — rota API Endereço e operação expostas por API para capacidade dada. Rotas diferentes retornam famílias distintas de resultados. Exemplo : /v1/transit/nearby busca locais de transporte. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Parâmetro de consulta Valor enviado na URL após o ponto de interrogação. Nome e formato definidos pela interface usada. Exemplo : modes=bus,tram seleciona modais em URL compatível. Aprofundar no guia : [Como integrar um mapa de mobilidade no seu site?](https://www.roote.ai/pt/guides/como-integrar-um-mapa-de-mobilidade-no-seu-site/) ## Status HTTP Código indicando resultado da requisição no nível HTTP. Deve ser complementado com validação do conteúdo e status de negócio. Exemplo : HTTP 200 pode conter status de erro no negócio. Aprofundar no guia : [Nenhum resultado ou erro API: como fazer a distinção?](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/) ## Resultado vazio — empty Busca que não retorna entidade no perímetro consultado. Não prova ausência física de serviço fora dos dados disponíveis. Exemplo : Nenhuma parada retornada com filtros aplicados. Aprofundar no guia : [Nenhum resultado ou erro API: como fazer a distinção?](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/) ## Resposta parcial — partial Resultado com informações utilizáveis porém limitadas ou com elementos faltantes reportados. Acompanhado de avisos pertinentes. Exemplo : Fonte responde enquanto outra está indisponível. Aprofundar no guia : [Nenhum resultado ou erro API: como fazer a distinção?](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/) ## Tempo esgotado — timeout Interrupção de espera que ultrapassa duração prevista de operação. Indica busca não concluída, não ausência de resultados. Exemplo : App oferece tentar novamente em vez de mostrar lista vazia. Aprofundar no guia : [Nenhum resultado ou erro API: como fazer a distinção?](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/) ## Limite de frequência — rate limit Restrição no ritmo de requisições permitidas por serviço. Regras e orientações para retomada dependem do contrato ativo. Exemplo : Código 429 indica respeitar orientações de retomada. Aprofundar no guia : [Nenhum resultado ou erro API: como fazer a distinção?](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/) ## Token Bearer Identificador de acesso enviado em cabeçalho Authorization conforme mecanismo previsto. Deve ser mantido seguro na configuração. Exemplo : Authorization: Bearer usado sem expor token na URL. Aprofundar no guia : [Como conectar um assistente IA ao MCP ROOTE?](https://www.roote.ai/pt/guides/como-conectar-um-assistente-ia-ao-mcp-roote/) ## JSON Formato textual estruturado com objetos, arrays, strings e números. JSON válido pode não seguir esquema da API. Exemplo : Coleção stations deve ter tipo e campos esperados. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## OpenAPI Especificação que descreve contrato de API HTTP em documento estruturado. Ajuda a verificar rotas, parâmetros, respostas e esquemas. Exemplo : Contrato ROOTE publicado em openapi.json. Aprofundar no guia : [Como pesquisar as paradas de transporte próximas com uma API?](https://www.roote.ai/pt/guides/como-pesquisar-paradas-de-transporte-proximas-com-uma-api/) ## Embed — mapa incorporado Inserção de experiência externa numa página, ex.: mapa em iframe. Parâmetros e permissões definem contexto de uso. Exemplo : Iframe ROOTE mostra bicicletas perto de Bordeaux. Aprofundar no guia : [Como integrar um mapa de mobilidade no seu site?](https://www.roote.ai/pt/guides/como-integrar-um-mapa-de-mobilidade-no-seu-site/) ## Iframe Elemento HTML que carrega documento dentro da página. Em domínios distintos, página pai não lê livremente estado interno do documento embutido. Exemplo : Mudanças de busca exigem troca documentada para comunicar ao pai. Aprofundar no guia : [Como integrar um mapa de mobilidade no seu site?](https://www.roote.ai/pt/guides/como-integrar-um-mapa-de-mobilidade-no-seu-site/) ## MCP — Model Context Protocol Protocolo para aplicação IA comunicar com servidores que expõem ferramentas ou contexto. Não define sozinho qualidade dos dados retornados. Exemplo : Assistente descobre ferramentas de busca ROOTE. Aprofundar no guia : [O que é um servidor MCP e para que serve?](https://www.roote.ai/pt/guides/o-que-e-um-servidor-mcp-e-para-que-serve/) ## Servidor MCP Programa que expõe capacidades conforme protocolo MCP. Ferramentas anunciadas definem o que cliente pode chamar. Exemplo : tools/list permite consultar inventário disponível. Aprofundar no guia : [O que é um servidor MCP e para que serve?](https://www.roote.ai/pt/guides/o-que-e-um-servidor-mcp-e-para-que-serve/) ## Cliente MCP Componente IA que se comunica com servidor MCP. Gerencia troca do protocolo para essa conexão. Exemplo : Cliente envia argumentos de busca ao ROOTE. Aprofundar no guia : [O que é um servidor MCP e para que serve?](https://www.roote.ai/pt/guides/o-que-e-um-servidor-mcp-e-para-que-serve/) ## Aplicação hospedeira MCP Aplicação que atende interação com usuário e gerencia um ou mais clientes MCP. Responsável por usar resultados na experiência. Exemplo : App conversacional conecta servidor ROOTE. Aprofundar no guia : [O que é um servidor MCP e para que serve?](https://www.roote.ai/pt/guides/o-que-e-um-servidor-mcp-e-para-que-serve/) ## Ferramenta MCP Capacidade executável descrita por nome, função e esquema de argumentos. Assistente deve usar entradas aceitas pelo esquema. Exemplo : geocode recebe endereço; transit_nearby recebe coordenadas. Aprofundar no guia : [Como conectar um assistente IA ao MCP ROOTE?](https://www.roote.ai/pt/guides/como-conectar-um-assistente-ia-ao-mcp-roote/) ## Streamable HTTP Transporte MCP para comunicação HTTP com servidor remoto. Suporte deve ser verificado no cliente usado. Exemplo : Servidor ROOTE remoto usa https://mcp.roote.ai/mcp. Aprofundar no guia : [Como conectar um assistente IA ao MCP ROOTE?](https://www.roote.ai/pt/guides/como-conectar-um-assistente-ia-ao-mcp-roote/) ## Resposta fundamentada — grounding Construção de resposta a partir de informações efetivamente obtidas ou fornecidas. Campos faltantes e reservas devem ficar visíveis. Exemplo : Assistente usa locais retornados sem inventar horários. Aprofundar no guia : [Como criar um assistente que encontra as mobilidades ao redor de um endereço?](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/) ## Alucinação de assistente IA Produção de informação sem base, apresentada como certa. Em mobilidade, pode ser horário ou disponibilidade inventados. Exemplo : Assistente anuncia passagem quando ferramenta apenas retornou parada. Aprofundar no guia : [Como criar um assistente que encontra as mobilidades ao redor de um endereço?](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/) ## Injeção de prompt Tentativa de usar conteúdo externo para alterar instruções de assistente. Descrições de fornecedores devem ser dados, não ordens. Exemplo : Instrução oculta no nome de local não deve ser executada. Aprofundar no guia : [Como criar um assistente que encontra as mobilidades ao redor de um endereço?](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/) ## Somente leitura Capacidade de consulta sem ação de modificação pelo recurso. Consultar disponibilidade não reserva, destrava nem aluga veículo. Exemplo : Ferramentas Dados ROOTE servem para consultar informações. Aprofundar no guia : [O que é um servidor MCP e para que serve?](https://www.roote.ai/pt/guides/o-que-e-um-servidor-mcp-e-para-que-serve/)