Pular para o conteúdo principal

Registro de alterações

Principais alterações no SDK de incorporação, na API da plataforma e nesta documentação. O SDK é versionado em /embed/v1/* e a API em /inference-api/b2b/v1/*; alterações incompatíveis são lançadas como uma nova versão principal ao lado da antiga (Versionamento da CDN). Mudanças aditivas, como novos eventos de streaming ou campos de resposta, são lançadas sem mudar a versão. Por isso, os clientes devem ignorar elementos que não reconhecem.

2026-10-21: barra de chat do Viewer e respostas baseadas nos lugares do próprio mapa ativadas​

  • Uma barra de chat para sua página. <kaleidr-map product="viewer" layout="bar"> é um único campo de pergunta que abre o mapa publicado com a pergunta do visitante: sobre a página, por padrão, ou na sua própria página com results-url. Título, placeholder, perguntas de exemplo, cor de destaque, tema e idioma são atributos. Veja Barra de chat.
  • Um Viewer pode abrir com uma pergunta. prompt, ou prompt-param para lê-lo da URL da página, e o parâmetro q do iframe fazem uma pergunta ao Kaleidr AI do mapa quando ele abre; handle.send() pergunta a partir do código. Aditivo: sem mudança de versão.
  • As respostas baseadas nos lugares do próprio mapa estão ativadas. O painel Ask Kaleidr em um mapa publicado ou link de compartilhamento responde primeiro com base nos lugares nomeados que o mapa mostra. Veja Respostas baseadas nos lugares do próprio mapa.
  • A loja de templates escreve o código. template.kaleidr.com gera os dois snippets para um mapa que você escolher. Os templates de site para download foram descontinuados.

2026-10-18: o Kaleidr AI de um link de compartilhamento precisa do mapa publicado​

  • O Kaleidr AI de um link de compartilhamento para quando a publicação do mapa é cancelada. Ele também só funciona nas páginas que os domínios permitidos do mapa incluem agora, e não nos do instantâneo do link. Cancelar a publicação do mapa ou remover o domínio de uma página o interrompe em até cinco minutos, como no mapa publicado, e publicar novamente o restaura. Os interruptores Control Tower e Popup Window continuam vindo do instantâneo, e o próprio link continua mostrando o mapa. POST /sdk/share-sessions retorna 404 not_found para um link de compartilhamento cujo mapa não está publicado. Veja Kaleidr AI em um mapa publicado.

2026-10-16: o Kaleidr AI em um mapa publicado segue os interruptores do próprio mapa​

  • O bloco Kaleidr AI do mapa é o único interruptor. No Studio, Control Tower oferece aos visitantes do mapa publicado o painel Ask Kaleidr e Popup Window oferece o chat com IA nos pop-ups, tanto no iframe quanto no elemento Viewer. O interruptor Visitor AI Chat em Share, Embed foi removido. Consulte Kaleidr AI em um mapa publicado.
  • Sem limite mensal por mapa. O campo Monthly AI Credit Limit foi removido. Os visitantes gastam os créditos de IA do proprietário até a franquia do plano; os limites de taxa por visitante e por mapa não mudaram.
  • POST /sdk/share-sessions aceita feature. control_tower (o padrão) ou popups, cada um concedido apenas enquanto seu interruptor está ativo; caso contrário, 403 chat_disabled. Consulte POST /sdk/share-sessions.
  • Um link de compartilhamento também abre o Kaleidr AI. Seu ID é concedido a partir do instantâneo do link: os interruptores Control Tower e Popup Window e os domínios permitidos como estavam quando o link foi criado, com o proprietário do mapa pagando. Desligar o Kaleidr AI no Studio não o desativa em um link de compartilhamento já distribuído. Um ID desconhecido continua retornando 404 not_found.
  • Viewer e Tile aplicam zoom com a rolagem, como no Studio. Rolar com o ponteiro sobre o mapa aplica zoom, sem Ctrl nem ⌘; com o ponteiro fora do mapa, a rolagem move a página. O parâmetro de iframe gestures=greedy não é mais lido.

2026-10-14: informações em um ponto e dois endpoints descontinuados​

  • Novo: POST /spot e POST /spot/overview/stream. /spot informa o que existe em um ponto: o local clicado, o endereço mais próximo e as regiões que abrangem o ponto, cada valor com a atribuição que deve ser exibida. Sob demanda, inclui conteúdo descritivo e fotos do local. /spot/overview/stream transmite um resumo de um item retornado, após um quadro place com o nome completo do local. Consulte POST /spot.
  • /spot cobra pelo conteúdo apenas quando ele é obtido para a chamada. Conteúdo já obtido para uma solicitação anterior não é cobrado, então uma consulta de conteúdo em /spot custa o mesmo que /retrieval/poi/enrich ou menos.
  • Obsoletos: GET /retrieval/poi/enrich e POST /chat/summary/stream. Continuam funcionando até 2027-01-15 e podem ser removidos depois. As respostas incluem Deprecation, Sunset e um Link para a alternativa. Consulte Migração dos endpoints obsoletos.
  • Os tenants são retornados. /spot retorna os estabelecimentos dentro de um prédio como entidades tenant, com referência poi:, sob CDLA-Permissive-2.0, em vez de omiti-los. O acesso continua gratuito.
  • Todo resumo é cobrado. Resumos e apresentações de locais são cobrados pelos tokens usados em cada solicitação; o campo cached dos eventos start e end não é mais enviado.
  • Resumos de prédios não têm substituto. A descrição de um prédio não está disponível na API. Consulte O que a API não retorna. /spot/overview/stream aceita building: sem id e responde, como a building:<id>, com um quadro error.

2026-10-13: alterações no produto e documentação corrigida e ampliada​

Esta entrada tem duas partes. Alterações no produto e Limites e recusas da API apresentam o que mudou no produto nesta versão. Correções destas páginas identifica trechos em que a documentação descrevia funções que o produto não oferece: as páginas foram conferidas linha a linha com o SDK e a API e, depois, corrigidas e ampliadas. Se você desenvolveu com base em uma versão anterior destas páginas, leia as correções.

Alterações no produto​

  • Os dados empresariais são enviados pelo Kaleidr Studio. A tela de envio fica na seção Data for AI Answers, no final do painel Dados de qualquer mapa: escolha um arquivo .csv ou .json, proponha e revise o mapeamento das colunas de um CSV, visualize, publique e veja o resultado na lista Releases. Essa é a única tela de envio. Os controles aparecem apenas para proprietários e administradores de organizações com permissão de envio e usam o mesmo fluxo de processamento da API de envio, sem mudanças. Uma organização que saiu do Enterprise e ainda possui versões mantém a seção para seus proprietários e administradores, com o aviso “O envio faz parte do plano Enterprise.” e a lista Releases. Os demais planos abaixo de Enterprise não exibem essa área. Consulte Respostas com seus próprios dados e Exibição da seção sem permissão para enviar.
  • Dados empresariais são exclusivos do Enterprise para envio e respostas. Proprietários ou administradores de uma organização Enterprise podem enviar e publicar. O assistente do Kaleidr Studio só responde com base nesses dados aos membros autenticados da organização enquanto ela permanecer no Enterprise. Free e Pro não permitem o envio. Os limites de locais, documentos e tamanho de arquivos são definidos por organização no contrato e nunca ultrapassam os limites máximos da plataforma. Um envio acima do limite retorna 422 com o limite e o plano informados no motivo. O plano válido é o contratado e alterado em kaleidr.com/billing. Para ler esses dados pela API ou SDK também é necessário o escopo vendor, exclusivo do Enterprise. Consulte Disponibilidade por plano.
  • Conjuntos de dados em um mapa têm limites por plano. Arquivos adicionados por usuários autenticados no painel Dados do Kaleidr Studio estão disponíveis em todos os planos, com limites diferentes: Free permite 50.000 linhas por conjunto, 32 MiB por arquivo e 250.000 linhas em todos os conjuntos da organização; Pro permite 100.000 linhas, 64 MiB e 5.000.000 de linhas. No Enterprise, os limites por conjunto e por arquivo são iguais aos do Pro e o limite total da organização é definido em contrato. Ultrapassar o limite do plano recusa apenas novos envios com HTTP 402 quota_exceeded; os dados existentes permanecem. Quatro limites máximos se aplicam a todos os planos, inclusive Enterprise, e retornam HTTP 400 VALIDATION_ERROR, não 402: arquivos com mais de 64 MiB, conjuntos com mais de 100.000 linhas, arquivos geográficos com mais de 50.000 feições e sobreposições de imagem com mais de 16 MiB (a imagem gerada pelo Studio a partir de um GeoTIFF, não o arquivo GeoTIFF original). JSON colado no carregador do Studio é salvo dentro do mapa, para qualquer usuário, e não entra nesses limites. Consulte Conjuntos de dados em mapas e Erros.
  • Um envio de conjunto de dados recusado não adiciona nada ao mapa. No Studio, qualquer recusa do servidor aparece ao lado do controle de envio e o arquivo não é adicionado: limite do plano (402) com mensagem do servidor e link Upgrade Plan, sessão desconectada, falta de permissão, arquivo muito grande, envios em excesso ou outra recusa, incluindo 400 para limite máximo. Apenas quando o servidor não responde, excede o prazo ou falha é que as linhas podem ser salvas diretamente no mapa com um aviso, e somente se a tabela estiver dentro dos limites do plano. Caso contrário, nada é adicionado. Consulte Quando um envio falha.
  • Excluir um conjunto de dados do painel Dados é definitivo. O botão de lixeira de um conjunto salvo pede confirmação, depois exclui o conjunto, remove suas camadas do mapa e libera as linhas da cota da organização. O conjunto deixa de ser disponibilizado no mapa publicado e nos links de compartilhamento. Enviar um arquivo com o mesmo nome substitui o antigo quando o novo é salvo; se o novo não puder ser lido, o mapa volta aos dados anteriores e o Studio avisa. Desfazer pode restaurar a referência do mapa ao conjunto excluído, mas a camada não será desenhada. Consulte Excluir ou substituir um conjunto.
  • Os limites do Studio seguem o plano Kaleidr da organização. A quantidade de mapas que uma organização pode manter e os limites dos conjuntos acima dependem do plano contratado e alterado em kaleidr.com/billing. O Kaleidr Studio não tem um plano separado.
  • Mapas publicados e links compartilhados exibem os dados enviados ao mapa. Os conjuntos adicionados no painel Dados do Studio são renderizados como camadas, assim como as sobreposições de imagem, no visualizador incorporado e nos links compartilhados. Apenas os dados incluídos no mapa publicado são fornecidos. Excluir o conjunto no painel Dados interrompe sua distribuição em todos os lugares: no mapa publicado e nos links que o exibiam. Despublicar o mapa interrompe suas incorporações, mas links compartilhados anteriormente continuam funcionando com os dados que já possuíam. Navegadores mantêm dados já carregados e um link de download emitido pode continuar acessível por até uma hora. Cada visitante baixa o conjunto inteiro com todas as colunas; portanto, tabelas grandes demoram mais para carregar e um conjunto publicado é público. Consulte Dados enviados em um mapa publicado.
  • É possível despublicar um mapa pelo Studio. A página Publish & embed apresenta o botão Unpublish para um mapa ativo, mediante confirmação. Todas as incorporações passam a mostrar que o mapa está indisponível. O mapa mantém seu ID, então uma nova publicação restaura as mesmas URLs incorporadas. Consulte Despublicar um mapa.
  • O assistente de IA do Studio responde sobre o conjunto de dados inteiro. No mapa aberto, ele trabalha com todas as linhas do conjunto enviado, não apenas uma amostra: pode filtrar, ordenar, contar, somar, calcular médias, agrupar e buscar linhas próximas de um ponto ou dentro de uma área. Trabalha com um conjunto por vez, lista até 100 linhas ou grupos e apenas lê os dados, sem alterá-los. Consulte Perguntar ao assistente sobre um conjunto.
  • Os conjuntos de dados têm papéis de coluna. Após o envio, o Studio identifica as colunas Nome, Categoria, Descrição e Endereço; o autor pode corrigir os papéis na seção Column Roles do conjunto, no painel Dados. A coluna Nome é a que o assistente de IA do Studio e o chat de um mapa publicado usam para nomear cada local. Enviar um arquivo de mesmo nome armazena um novo conjunto; os papéis anteriores são reutilizados nas colunas que ainda existirem. Consulte Papéis das colunas.
  • O Visitor AI Chat pode responder com conjuntos enviados a um mapa publicado, quando as respostas a partir dos locais do mapa estão habilitadas. A Kaleidr controla esse recurso na plataforma e ele fica desligado por padrão. Quando ativado, os locais consultados pelo chat incluem linhas dos conjuntos presentes no mapa publicado, desde que o conjunto tenha uma coluna Nome e a linha tenha coordenadas de ponto, respeitando o limite de 200 locais por mapa. Consulte Respostas a partir dos locais do mapa.
  • Uma nova chamada informa o que a organização pode enviar. GET /shared-api/datahub/limits retorna se a organização pode enviar dados empresariais, seu plano e limites. Retorna 200 em todos os planos, com can_upload: false abaixo de Enterprise. A seção do Studio apresenta os mesmos limites em uma linha. Consulte O que sua organização pode enviar.
  • A recusa para planos sem permissão de envio é 403 vendor_data_not_on_plan. Substitui o código antes documentado, que deixou de ser retornado. Atualize clientes que verificam o código antigo.
  • Uma versão pode ser despublicada e excluída. POST /shared-api/datahub/releases/{id}/unpublish retira imediatamente uma versão publicada de serviço; DELETE /shared-api/datahub/releases/{id} remove uma versão não publicada com tudo o que foi gerado a partir dela. Ambas as operações são permitidas para proprietários ou administradores em qualquer plano, inclusive após downgrade. A lista Releases no Studio oferece Unpublish e Delete, inclusive para organizações que saíram do Enterprise e ainda têm versões. A lista passou a incluir state e ingest_id. Consulte Retirar uma versão.
  • Versões antigas são removidas automaticamente. Versões que deixaram de ser atuais (substituídas, despublicadas ou prévias expiradas) são excluídas 30 dias após perderem esse status. Versões com falha são excluídas 30 dias após a última tentativa de processamento. Consulte Retenção de versões.
  • Uma proposta de mapeamento consome créditos de IA. POST /inference-api/vendor/mapping/propose é cobrada dos créditos de IA da organização e retorna 429 quota_exceeded quando eles acabam. O limite de 30 propostas por conta a cada hora permanece; os dois 429 têm corpos diferentes. Consulte Distinguir os dois 429.
  • O escopo vendor é exclusivo do Enterprise. Chaves Free e Pro não podem ter esse escopo. Criar uma chave solicitando vendor nesses planos retorna 403 tier_capability_not_allowed; anteriormente o Free o removia sem erro e o Pro permitia criá-lo. Rotacionar uma chave que tinha vendor em um plano abaixo de Enterprise cria uma chave sem o escopo. Após sair do Enterprise, chaves existentes deixam de acessar os dados sem apresentar erro e sessões de navegador já abertas são encerradas. O Pro continua permitindo chaves de servidor e mais chaves ativas. Consulte Autenticação e escopos.
  • O Chat aceita idioma, título e texto de exemplo. Novas opções de montagem lang, title e placeholder; no elemento, os atributos lang, chat-title e placeholder. Sem lang, o painel usa <html lang> da página se for válido; caso contrário, inglês. Consulte Referência do Chat.
  • <kaleidr-map> é um elemento de bloco por padrão. O elemento usa display:block a menos que seu CSS defina outra coisa, fazendo com que height seja aplicado. Antes a altura não funcionava sem definir também display:block. Exemplos continuam incluindo display:block para Safari anterior à versão 16.4. Consulte Dimensionamento.
  • Chamadas ao controlador logo após a montagem são preservadas. Em Viewer e Tile, um setCamera (e, em Tile, setStyle) executado antes de o mapa do quadro estar pronto é aplicado quando ele fica pronto, até as 256 chamadas mais recentes. Antes essas chamadas eram perdidas. Se o mapa não confirmar que está pronto após uma espera limitada, normalmente 10 segundos após o quadro carregar, as chamadas preservadas são enviadas mesmo assim, com um aviso no console. Não é mais necessário aguardar kaleidr-embed:ready antes de usar o controlador.
  • A substituição da base da CDN aceita apenas três tipos de origem. A opção e o atributo base, além de window.__KALEIDR_EMBED_BASE__, só são respeitados para a CDN Kaleidr (https://cdn.kaleidr.com), a origem de onde kaleidr.js foi carregado ou a própria origem da página. Qualquer outro valor é ignorado com aviso no console e usa-se a CDN padrão. A hospedagem própria funciona se o carregador e os pacotes vierem da mesma origem. Consulte Versionamento da CDN.
  • Os scripts dos produtos carregam em UTF-8 em todas as páginas. O carregador usa UTF-8 independentemente da codificação declarada pela página. Antes, em páginas sem declaração, Chat ou Editor podiam não montar e mostrar chat.js loaded but window.KaleidrGeoChat is missing no console. Consulte Solução de problemas.
  • Montar novamente no mesmo elemento após destroy() é seguro, inclusive se a primeira montagem ainda estiver carregando, como ocorre no modo estrito do React.
  • Uma solicitação recusada não retém créditos. Uma solicitação recusada antes do processamento (limite de frequência ou concorrência, erro de validação ou corpo grande demais) não mantém créditos de IA nem uma vaga de concorrência. Consulte Cotas e limites de frequência.
  • A câmera da página prevalece em Viewer e Tile. Uma câmera fornecida na carga (center, zoom, pitch, bearing ou camera na URL de iframe) ou por setCamera prevalece sobre a vista salva pelo autor, inclusive a vista adaptada à largura da tela e ao enquadramento do conteúdo, e encerra o reenquadramento automático no redimensionamento. Campos não fornecidos mantêm os valores do autor; zoom na carga sem center é ignorado. Consulte Câmera.
  • O Chat em elementos Viewer ou Tile mantém seus marcadores. Como nos outros mapas, os marcadores se acumulam entre respostas, e um local repetido com coordenadas novas move o marcador existente, em vez de adicionar outro. Fechar ou destruir o chat remove seus marcadores, rotas e tudo que ele desenhou. Consulte Capacidades e limites.
  • O title do Chat é o título do painel. O título informado aparece no cabeçalho da janela em todas as conversas assim que começam. Antes o título gerado pela conversa o substituía. Um chat minimizado mostra o título de sua própria conversa. Consulte Título e texto de exemplo.
  • O Editor identifica as solicitações de mapa base com sua chave publicável. Um Editor montado por kaleidr.js envia a chave publicável da página a https://tile.kaleidr.com para carregar o estilo, sprites e fontes. Nenhum token de sessão é incluído em uma URL. Não há opção nova. Consulte O que roda na sua página.

Limites e recusas da API​

  • Solicitações de fluxo de chat têm limites e códigos próprios. 422 too_many_messages, message_too_long, conversation_too_long, invalid_session_id e lang_too_long. Consulte Endpoints.
  • Os fluxos de resumo e de botões recusam campos longos demais com 422 field_too_long.
  • Corpos de solicitação acima de 2 MiB (5 MiB para endpoints de design) são recusados com 413 request_too_large.
  • Um fluxo de chat encerrado antes de completar é cobrado pelo menos pelo tamanho da conversa enviada.
  • Tokens de sessão expõem menos dados. Para eles, a resposta 429 quota_exceeded e o evento quota não incluem mais plano, uso ou limite.
  • A restrição de produto de uma chave de servidor ou legada é aplicada em todas as solicitações com 403 product_not_allowed.
  • O envio de dados empresariais recebeu limites por campo e lista, 413 request_body_too_large, 409 org_ingest_in_progress e 429 ingest_rate_limited. A proposta de mapeamento requer um proprietário ou administrador de organização que possa enviar dados (Enterprise). Consulte Enviar seus dados empresariais.
  • O envio de conjuntos no Kaleidr Studio acima do limite do plano retorna 402 quota_exceeded, e acima de um limite máximo comum a todos os planos retorna 400 VALIDATION_ERROR. Consulte Erros.

Correções destas páginas​

Cada item abaixo aponta um erro da documentação; o produto não foi alterado.

Códigos de erro e status

  • Uma solicitação acima da cota de créditos de IA retorna 429 com "error": "quota_exceeded". As páginas anteriores citavam b2b.tokens_exceeded, código que a API nunca retornou. Faltavam também detail, product e period no corpo documentado.
  • O código map_load_hard_stop não existe. Consulte “Planos” abaixo.
  • Trocar uma chave por sessão a partir de origem não permitida retorna 403 origin_not_allowed. Antes era citado session_origin_mismatch, que se refere a token usado em origem diferente daquela em que foi emitido.
  • vendor_scope_requires_acknowledgement é 422, não 403, e só se aplica a chaves publicáveis.
  • sessions_disabled é 404 e sessions_not_configured é 503. Ambos eram apresentados como 403.
  • Uma resposta 401 contém {"detail": "Invalid or missing API key"}. Antes era descrita como sem corpo.
  • map_load_quota_exceeded retorna {"detail": "map_load_quota_exceeded"}. O corpo plano de exemplo anterior não existe.
  • Uma falha do serviço de chaves retorna 401, não 503.
  • Passar uma chave à incorporação Viewer não causa product_not_allowed. Viewer não precisa de chave.
  • Foram incluídos códigos antes ausentes: visitor_limit_reached, chat_disabled, not_found, owner_has_no_organization, org_admin_required, key_not_found e key_already_rotated.
  • key_already_rotated e key_expired ao editar dizem respeito apenas a expires_at; outros campos ainda podem ser editados. Revogar novamente uma chave já revogada retorna 200.
  • Onde aparece o código da recusa. Uma resposta 403 ou 404 leva o código em detail. Uma resposta 429 da API da plataforma usa error, com explicação em detail; map_load_quota_exceeded é exceção e aparece em detail. Os 429 da API de envio aparecem em Formatos de resposta.

O catálogo completo está em Erros.

Planos, cotas e chaves

  • Dados próprios nas respostas eram descritos como disponíveis “a partir do Pro”. Dados empresariais em respostas de IA são exclusivos do Enterprise, tanto para envio como para leitura pelo escopo vendor na API ou no SDK. Free e Pro têm outro recurso: conjuntos de dados adicionados a mapas no Kaleidr Studio. Consulte “Alterações do produto” acima.
  • Carregamentos de mapas param ao atingir a cota em todos os planos. Antes dizia-se que planos pagos continuavam até cinco vezes o limite. Isso não ocorre. Pacotes de carregamento aumentam a cota.
  • Os créditos de IA são um único saldo por organização, compartilhado pelas chaves de API e pelo uso dos aplicativos Kaleidr da equipe. Antes era apresentado um orçamento mensal de tokens de API separado.
  • O período da cota é o ciclo de cobrança, não necessariamente o mês do calendário.
  • Os limites de frequência são por chave; os de concorrência são por organização. Antes dizia-se que as chaves compartilhavam o limite.
  • A lista de origens permitidas é opcional para chaves publicáveis. Uma página exigia ao menos uma origem para chaves ativas; lista vazia permite qualquer origem.
  • Escopos não podem ser editados após a criação de uma chave. As páginas que descreviam edição ou remoção estavam incorretas: crie uma nova chave e revogue a antiga.
  • Chaves de servidor e legadas são enviadas diretamente nas chamadas em tempo de execução. Uma página dizia que todas essas chamadas exigiam token de sessão.
  • Rotação no Free. Rotacionar uma chave publicável no Free concede todas as capacidades Free (ai, maps, design e os quatro produtos), independentemente da chave anterior. Rotacionar chave de servidor ou legada no Free retorna 403 free_plan_publishable_only.
  • monthly_cap_tokens: valor 1 ou maior estabelece limite; 0 ou null significa sem limite.
  • org_id na criação da chave pertence ao corpo JSON. O parâmetro de consulta org_id só é lido nas outras rotas de chaves.
  • Visitor AI Chat conta cada solicitação. Uma pergunta gera uma solicitação de resposta e outra de fotos para cada cartão de resultado. Abrir um cartão, fazer uma pergunta adicional, pesquisar endereço nas Direções e calcular rota são outras solicitações, todas sujeitas ao limite por visitante. Consulte Chat em um mapa publicado.

Consulte Cotas e limites de taxa e Autenticação e escopos.

Streaming

  • O evento quota é o último do fluxo, após end ou error. Antes era documentado como intermediário. Ele informa o uso, não consegue alertar antes de o fluxo terminar.
  • Um evento place pode chegar sem coordenadas, marcado unverified: true.
  • O evento error só traz code em um caso: upstream_stall.
  • Os eventos de cartões e camadas enviados pelo fluxo (weather_card, building_card, arrivals_card e outros) agora estão listados.
  • Os fluxos de resumo e de botões agora estão documentados.
  • O evento quota de um token de sessão contém apenas type, meter e reset_at. Um exemplo antigo mostrava números de uso, retornados somente às chaves de servidor.
  • end repete cinco eventos de cartões e camadas, não todos: weather_card, satellite_card, constellation_layer, weather_layer e vehicles_layer.

Consulte o contrato de transmissão SSE.

Pontos de acesso da API

  • Os corpos de POST /design/analyze e POST /design/apply-direct estavam errados; o exemplo de análise retornava 422. Ambos foram corrigidos e as respostas do catálogo são mostradas com sua chave externa.
  • POST /chat/control/route aceita lat e lng diretamente em cada local, não dentro de coordinates.
  • Mensagens system enviadas a POST /chat/control/stream são ignoradas. Isso não estava documentado.

Consulte Endpoints.

Mapas publicados e links de compartilhamento

  • Um mapa publicado mostra o estado atualmente salvo. Antes dizia-se que a incorporação mostrava “a última versão publicada” e era atualizada por Re-publish. Na realidade, uma alteração salva no Studio, inclusive um conjunto adicionado, torna-se pública na próxima vez que a incorporação carregar, sem republicar. Re-publish registra uma nova versão publicada, mantendo ID, link e código de incorporação. Para alterar o mapa em particular, despublique antes e publique novamente quando concluir. Consulte Incorporar um mapa.
  • Links compartilhados não podem ser excluídos nem pausados no Studio. Abrir a caixa Share publica o mapa e cria um novo link a cada vez. O link é um retrato do design do mapa e continua funcionando após a despublicação, até que o mapa seja excluído ou a Kaleidr remova o link a pedido do usuário. Páginas anteriores descreviam botões de exclusão e pausa inexistentes. Consulte Links compartilhados.

SDK e incorporações

  • Chat move o mapa. Antes dizia-se que o chat não controlava a câmera. Na verdade, ele movimenta e ajusta a visualização aos locais citados na resposta, adiciona marcadores e desenha rotas. Só o setCamera do controlador de montagem não é compatível com Chat.
  • Escopo do Editor. O Editor incorporado funciona dentro da página, com o trabalho mantido na memória. Ele não salva, exporta nem publica e não chama a API de design. As páginas que descreviam publicar por essa incorporação estavam erradas.
  • Hosts da Content Security Policy. O Editor carrega o mapa base de https://tile.kaleidr.com, antes ausente da política. Nenhuma incorporação contata hosts de mapas de terceiros por padrão. Chat carrega ícones de sites citados pelo serviço de favicon do Google, agora listado na política e em Capacidades e limites.
  • Leaflet voltou a ser documentado como mapa compatível com Chat, ao lado de Mapbox GL JS, MapLibre GL JS e Google Maps JavaScript API.
  • A URL do quadro Tile não contém credenciais. Contém só o ID do estilo e a câmera, nem chave publicável nem token de sessão. A troca de sessão do Tile verifica a chave, conta o carregamento e retorna o mapa base padrão da organização; o mapa no quadro não usa a credencial em chamadas. Consulte Referência Tile.
  • Kaleidr.enable(false) só retém montagens feitas depois da chamada. Um elemento <kaleidr-map> já lido pelo navegador quando o carregador executa é montado imediatamente antes da sua chamada. Use a sinalização de página window.__KALEIDR_EMBED_ENABLED__ = false antes do carregador.
  • Kaleidr.mount sem objeto de opções lança um TypeError. Todas as outras falhas de montagem registram um erro com [kaleidr:<product>] (exibido como Error: [kaleidr:…) no console, sem lançar exceção.
  • A barra do Editor incorporado inclui Text, Image, Marker, Popup, Background, Layer, Design e Legend. Antes dizia-se que não havia Design; na realidade faltam o catálogo de design do Studio, a aba Data, o painel de IA e a biblioteca de modelos 3D.
  • kaleidr-plain tem prédios 3D a partir do zoom 15; antes era descrito sem eles.
  • Tile sem estilo e sem padrão da organização emite kaleidr-embed:error com code: 'no_id' e id: null.
  • shareId no Viewer aceita o ID de um mapa publicado ou o ID de 16 caracteres de um link compartilhado. Chat em mapa publicado aceita apenas o ID do mapa.

Novas páginas​

2026-10​

  • Mais informações por resultado de endereço. GET /retrieval/geocode/forward agora fornece id para endereço de rua (identificador da Kaleidr para a porta, estável entre atualizações). Um endereço estimado também tem within_m e score, além de method e matched_numbers. method pode ser "range": número de porta americano posicionado ao longo da quadra correspondente. São campos adicionais; consulte Endpoints.
  • Chaves de API no Free. A chave publicável de uma organização Free agora usa chat de IA, mapas publicados e Editor além de mapas base (escopos ai, maps, design; todos os produtos), consumindo créditos de IA do Free. Chaves de servidor exigem Pro ou Enterprise. (O escopo vendor é exclusivo de Enterprise desde 2026-10-13.) Os limites de chaves ativas por organização são Free 2, Pro 10 e Enterprise 25 (409 key_limit_reached; rotações não contam e chaves existentes acima do limite são mantidas).

2026-09​

  • Endereços na pesquisa de endereços. GET /retrieval/geocode/forward agora também retorna endereços de rua digitados (type: "address"). attribution.sources identifica cada base de endereços usada, a atribuição e restrições da licença; resultados G-NAF não podem ser usados para compilar listas de correspondência. Um número ausente é estimado com números vizinhos da mesma rua e marcado com approximate: true, method e matched_numbers. É uma extensão; os resultados de locais não mudam.
  • Rotas de transporte público. POST /chat/control/route aceita profile: "transit" e devolve viagem com um único transporte em action.payload.transit, ou { "error": "…" } se não houver trajeto direto. O corpo da solicitação não mudou; demais valores de profile continuam como antes. O novo GET /retrieval/geocode/forward (escopo ai, cobrado) serve à busca de origem/destino. A tela Direções do Chat recebeu campos de entrada De/Para e modo Transporte público.
  • As capacidades da chave seguem o plano atual. Tanto a troca de sessão quanto as chamadas em tempo de execução verificam a chave contra o plano vigente da organização, de modo que mudanças de plano funcionam sem editar ou rotacionar chaves. tier_capability_not_allowed significa que a chave tem a capacidade, mas o plano não a inclui mais; insufficient_scope significa que a chave nunca a teve.
  • Mudanças de plano afetam sessões emitidas. Um downgrade encerra sessões anteriores em poucos minutos, sem esperar a expiração. O upgrade vale a partir da próxima troca de sessão.
  • Edições de produtos no Free são verificadas. Alterar allowed_products de uma chave Free para lista vazia ou produto não permitido retorna 403 tier_capability_not_allowed.
  • Evento de fluxo grounding removido. Clientes que o monitoravam não o recebem mais.

2026-08​

  • Acesso ao mapa base exige chave. O uso direto de tile.kaleidr.com por terceiros é restrito; incorporações <kaleidr-map> e mapas hospedados pela Kaleidr não são afetados. Sessões Tile contam como carregamentos de mapa da organização (cota).
  • Troca e renovação de sessão. Chaves publicáveis são trocadas por sessões curtas vinculadas à origem (kld_sess_…, 15 minutos); o SDK as renova.
  • Chat pode controlar um elemento de mapa Kaleidr. Uma montagem do Chat pode definir map-target para um elemento Viewer ou Tile da mesma página.
  • Mapa base padrão da organização. POST /sdk/sessions retorna em basemap_style_id o mapa base padrão da organização; uma incorporação sem estilo explícito o utiliza.
  • Chaves de servidor são recusadas no navegador. O SDK rejeita kld_sk_… na montagem.
  • Opções de base separadas. viewerBase e tileBase foram separadas da opção base do carregador.
  • Cores de rota. O evento de fluxo route contém color, label, alternatives e comparison.

v1​

  • Carregador kaleidr.js e elemento <kaleidr-map>: um carregador e quatro produtos (chat, viewer, editor e tile).
  • Chaves publicáveis no navegador (kld_pk_) e chaves de servidor (kld_sk_) com escopos ai, maps, design e vendor; as publicáveis são trocadas por sessões curtas vinculadas à origem. Chaves legadas kld_live_ continuam funcionando.
  • Famílias de endpoints /inference-api/b2b/v1/chat/* (fluxo) e /design/*.