Biblioteca de locais
A Biblioteca de locais guarda os locais da sua organização como coleções: suas lojas, seus anúncios de imóveis, seus estabelecimentos. Você importa uma coleção uma vez, a partir de um arquivo, de uma planilha do Google Sheets ou de um feed, confere onde cada local foi parar e publica. A partir daí, qualquer mapa da sua organização pode mostrá-la, como pinos, como localizador de lojas ou como página de anúncios, e o Kaleidr AI nesses mapas responde a perguntas com base nela.
Uma coleção não é um conjunto de dados em um mapa. Um conjunto de dados pertence ao único mapa ao qual você o adicionou; uma coleção pertence à organização, e você a atualiza em um só lugar para todos os mapas que a mostram.
| Conjuntos de dados em um mapa | Coleções da Biblioteca de locais | |
|---|---|---|
| Pertence a | O mapa ao qual você o adicionou | A organização |
| Contém | Qualquer tabela, arquivo geográfico ou sobreposição de imagem | Locais: um ponto por linha, com um nome |
| Atualizado | Substituindo o conjunto de dados em cada mapa | Com uma importação, em todos os mapas que mostram a coleção |
| Colunas privadas | Não: os visitantes recebem todas as colunas | Sim: uma coluna marcada como Privada nunca sai do Studio |
| Layouts de localizador e de anúncios | Não | Sim |
| Planos | Free, Pro e Enterprise | Free, Pro e Enterprise |
Encontrar a Biblioteca
Entre no Kaleidr Studio e escolha Dados na barra da esquerda. A Biblioteca lista as coleções da sua organização, cada uma com o número de registros, quando foi publicada pela última vez, se é atualizada de forma programada e em quantos mapas aparece. A faixa no topo mostra quantas coleções e locais seu plano permite e quantos você usa.
Proprietários, administradores e membros podem criar, importar e alterar coleções. Leitores podem abri-las e ler seus locais.
Coleções
Escolha Nova coleção, escolha um tipo e dê um nome a ela. O tipo define quais campos o assistente de importação oferece primeiro e qual é a aparência do cartão de um local:
| Tipo | Para | Campos oferecidos primeiro |
|---|---|---|
| Lojas | Pontos de venda. O kit Retail. | Nome, endereço, categoria, horário, fuso horário, telefone, site, link de ação, seu ID, status |
| Anúncios | Imóveis à venda ou para alugar. O kit Property. | Nome, endereço, preço, moeda, quartos, banheiros, foto, status, link de ação, telefone, seu ID, descrição |
| Estabelecimentos | Hotéis, restaurantes e atrações. O kit Hospitality. | Nome, endereço, categoria, horário, telefone, site, foto, descrição, link de ação, seu ID |
| Paradas | Paradas programadas, como o trajeto de um food truck ou pontos de coleta. O kit Location. | Nome, endereço, horário (as janelas de atendimento), fuso horário, status, veículo, datas de atendimento, descrição, seu ID |
| Veículos | Os veículos de uma frota, mostrados ao vivo em um mapa. Consulte Rastreamento ao vivo. | Nenhum: os veículos são adicionados à frota no Studio, não importados |
| Personalizada | Quaisquer outros locais | Nome, endereço, categoria, descrição, seu ID |
Qualquer tipo também pode ter colunas próprias. Uma coleção de Lojas, Anúncios, Estabelecimentos ou Paradas começa com o cartão, os filtros e as ações do seu kit, que você pode alterar. Uma coleção de Veículos não aceita importação: seus veículos são gerenciados na seção Frota do Studio.
O Horário de uma coleção de Paradas são as suas janelas de atendimento. Uma parada cujo Status é paused não funciona em nenhum dia; uma coluna Veículo indica o veículo que atende a parada; uma coluna Datas de atendimento lista as únicas datas em que ela funciona. Consulte Horários das paradas.
Importar seus dados
Escolha Importar dados em uma coleção. O assistente de importação tem cinco etapas.
1. Adicione seus dados
Traga os dados de uma de três formas:
| Origem | O que informar | Atualizável |
|---|---|---|
| Um arquivo | CSV, TSV, Excel, ODS, GeoJSON, KML, GPX ou um shapefile em zip | Não: importe um novo arquivo para atualizar |
| Uma planilha do Google Sheets | O link da planilha, começando com https://docs.google.com/spreadsheets/d/. Antes, compartilhe a planilha como "Qualquer pessoa com o link pode ver"; uma planilha que exige login não pode ser lida. Um link para uma aba lê essa aba. | Sim |
| Um feed | Um endereço https:// de um arquivo CSV, JSON ou GeoJSON | Sim |
- Um local é um ponto. Um arquivo de mapa precisa conter pontos; linhas e áreas são recusadas. Sobreposições de imagem como GeoTIFF não são locais e também são recusadas.
- Cada linha precisa de um nome e de um endereço ou de coordenadas. Uma linha com coordenadas é posicionada exatamente onde elas indicam. Uma linha só com endereço é posicionada a partir do endereço.
- Baixar planilha de exemplo fornece um exemplo preenchido para o kit da coleção, com as colunas que o cartão do kit lê.
2. Associe as colunas
O Studio mostra uma linha para cada coluna dos seus dados, com valores de exemplo e o campo ao qual a coluna foi associada. Um rótulo indica como:
| Rótulo | Significado |
|---|---|
| Associada | O nome da coluna é um nome conhecido do campo, como "Latitude" ou "Store Name". |
| Correspondência próxima | O nome da coluna é parecido com um nome conhecido. |
| Sugerida pela IA | O Kaleidr AI sugeriu o campo de uma coluna que os nomes não resolviam. Ele lê os nomes das suas colunas e as cinco primeiras linhas para sugerir uma associação, e nunca grava nem altera seus dados. A sugestão conta para o uso do Kaleidr AI da sua organização. |
Confira cada linha e corrija qualquer campo errado. Uma coluna pode ser:
- Um campo padrão do tipo, como Nome, Endereço, Horário ou Preço. Os campos padrão são sempre públicos.
- Uma coluna personalizada, com seu próprio rótulo, e Pública ou Privada.
- Ignorar, para deixar a coluna de fora.
As colunas de rua, cidade, região, CEP e país são combinadas em um só endereço. A latitude e a longitude podem ser duas colunas, ou uma única coluna com as duas, em qualquer ordem. Escolha o Fuso horário em que o horário da coleção está escrito.
As colunas privadas ficam com você. Uma coluna privada é guardada para você no Studio, e nunca é enviada ao navegador de um visitante nem lida pelo Kaleidr AI. Para manter privado um campo padrão, como um número de telefone, associe-o como uma coluna personalizada privada.
3. Posicione os pinos
O Studio posiciona cada linha no mapa. As linhas com coordenadas as mantêm. As linhas com endereço são posicionadas apenas a partir do endereço, nunca a partir do nome do local, para que duas filiais da mesma marca não fiquem uma em cima da outra.
Em seguida, o Studio mostra quantas linhas foram Posicionados, quantas estão Para revisar e quantas ficaram Não encontrados, além de uma lista de revisão ao lado de um mapa:
- Aceitar pino mantém um pino que o Studio posicionou com pouca confiança.
- Corrigir pino permite arrastar o pino, ou clicar no mapa, até onde o local está.
- Remover deixa a linha fora desta importação.
Uma linha sem pino não pode ser publicada. Corrija-a, remova-a ou escolha Pular linhas sem pino para publicar sem essas linhas.
4. Limpeza
O Studio sugere alterações, agrupadas por tipo, e não muda nada até você aceitar:
| Tipo | O que encontra |
|---|---|
| Duplicados | Linhas com o mesmo ID, ou com o mesmo nome no mesmo lugar. Aceitar mantém a primeira linha. |
| Horários | Horários escritos de outra forma, como Mon-Fri 9am-5pm; Sat 10-4, reescritos em um só formato. Os horários que o Studio não consegue ler são sinalizados na linha e deixados em branco. |
| Categorias | Grafias de uma categoria que diferem em maiúsculas, espaços ou plural, unificadas com as categorias existentes da coleção. |
| Sites | Um endereço web sem https://, completado. |
Escolha Aceitar ou Manter original em cada uma, ou Aceitar tudo. Cada alteração precisa de uma decisão antes de você publicar.
5. Publicar
Publicar substitui os locais da coleção por esta importação. Todos os mapas que mostram a coleção exibem os novos locais na próxima vez que carregam. Um local mantém sua identidade entre importações, então um link ou um cartão que aponta para uma loja continua apontando para ela depois que você atualiza os dados.
Depois de publicar, você pode escolher Adicionar ao mapa e, para uma planilha do Google Sheets ou um feed, Programar atualização.
Mantê-la atualizada
A seção Atualização de uma coleção importada de uma planilha do Google Sheets ou de um feed lê esse link de novo:
- Atualizar agora, em todos os planos, lê o link com as associações de colunas usadas da última vez. Se as colunas da planilha mudaram, a importação para em Associe as colunas para você conferir.
- Uma programação, nos planos Pro e Enterprise, atualiza no intervalo que você escolher, não mais vezes do que seu plano permite (veja Limites). Com Publicar automaticamente ativado, uma atualização se publica sozinha, a menos que precise de revisão ou altere o número de locais em mais da metade; nesse caso, ela espera por você.
- Falhas repetidas pausam a programação. A seção mostra a última execução e seu resultado.
Colunas, cartão, filtros e ações
Abra uma coleção para alterar como ela aparece. Cada parte é uma seção recolhível:
- Registros: todos os locais, com busca. As colunas privadas ficam sinalizadas.
- Colunas: o rótulo de cada coluna, Pública ou Privada, sua Posição no cartão e sua ordem. Uma mudança de visibilidade vale para todos os mapas que mostram a coleção.
- Cartão e filtros: uma Prévia do cartão ao vivo, os Filtros para visitantes que um localizador de lojas ou uma página de anúncios oferece, e as Ações do local em cada cartão.
O cartão mostra um local quando um visitante o seleciona. As posições do cartão definem o que vai para onde: Título, Subtítulo, Imagem, Preço, até três Selos, até quatro Linhas de detalhe e uma linha de Crédito. Um campo que um local não tem é omitido do cartão, nunca exibido vazio. Um cartão de Lojas mostra Aberto agora ou Fechado, calculado a partir do horário do local no fuso horário dele. Um cartão de Anúncios mostra a linha de crédito, como "Anúncio cortesia de" uma imobiliária e um corretor, logo abaixo do preço.
Filtros para visitantes, na ordem que você definir:
| Filtro | Os visitantes podem |
|---|---|
| Busca | Digitar um nome, um endereço ou uma categoria. |
| Categoria | Escolher uma ou mais categorias. |
| Preço | Definir um mínimo e um máximo. |
| Quartos / Banheiros | Escolher 1+, 2+, 3+ ou 4+. |
| Aberto agora | Mostrar apenas os locais abertos neste momento. Os locais sem horário ficam ocultos enquanto o filtro está ativado. |
Ações do local, até quatro em cada cartão:
| Ação | O que o visitante recebe |
|---|---|
| Link | Um botão que abre uma página sua em uma nova aba, como "Shop" ou "Schedule a Tour". Escreva o endereço uma vez, com {id} onde entra o ID de cada local; o Link de ação próprio de um local o substitui. Os endereços precisam começar com https://. |
| Rotas | Um trajeto desenhado no mapa a partir de onde o visitante está, ou de um local que ele pesquise, e botões que abrem as instruções até o local no Apple Maps ou no Google Maps. |
| Ligar | Um link de telefone para o número do local. |
| Solicitação | Um botão como Reserve, Schedule a Tour ou Request Pickup que abre um formulário de solicitação. A solicitação chega à caixa de entrada da sua organização. Consulte Solicitações de reserva. |
Adicionar uma coleção a um mapa
Duas formas, com o mesmo resultado:
- No painel Dados de um mapa, escolha Adicionar da biblioteca e escolha uma coleção.
- Em uma coleção, escolha Adicionar ao mapa e escolha um mapa.
A coleção vira uma camada do mapa, que você estiliza como qualquer outra. Os anúncios são desenhados como etiquetas de preço; os outros tipos, como pontos. Um mapa pode mostrar várias coleções, e uma coleção pode estar em qualquer número de mapas da sua organização.
Quando o mapa é publicado, os visitantes veem as colunas públicas da coleção e nada mais. Atualizar a coleção atualiza todos os mapas que a mostram, sem republicar.
O Kaleidr AI responde com base nela. Em um mapa publicado com o Control Tower ativado, o painel Ask Kaleidr responde a perguntas como "a loja mais próxima com estacionamento" a partir dos locais da coleção e das colunas públicas dela, e o painel informa que as respostas são geradas por IA. Veja Chat em um mapa publicado.
Incorpore-a como localizador de lojas ou página de anúncios. Os layouts locator e listings mostram o mapa ao lado de uma lista pesquisável da coleção, com os filtros e os cartões dela. Veja Layouts de locais.
Kits
Quatro tipos de coleção vêm com um kit: um cartão, filtros, ações e um layout do viewer que funcionam juntos, e uma planilha de exemplo para começar.
| Kit | Tipo de coleção | Layout | Filtros | Ações |
|---|---|---|---|---|
| Retail | Lojas | locator | Busca, Categoria, Aberto agora | Rotas, Ligar, Shop |
| Property | Anúncios | listings | Preço, Quartos, Banheiros | Schedule a Tour, Contact Agent |
| Hospitality | Estabelecimentos | guide | Busca, Categoria, Aberto agora | Book, Rotas, Reserve |
| Location | Paradas | live | Busca, Aberto agora | Rotas, Request Pickup |
Os modelos de kit do criador de modelos criam um mapa que já contém uma coleção de exemplo nesse formato, e geram o código de incorporação com o layout do kit. Substitua os locais de exemplo pelos seus importando dados para essa coleção. A coleção de exemplo conta para o seu limite de coleções; se você estiver no limite, o mapa é criado sem ela. O modelo Location contém paradas de exemplo e nenhuma frota: adicione seus veículos na seção Frota do Studio. As ações Reserve e Request Pickup aparecem quando sua organização aceita solicitações.
Excluir uma coleção
Excluir coleção fica na parte inferior de uma coleção. Se algum dos seus mapas mostrar a coleção, o Studio os lista primeiro, e Excluir mesmo assim a exclui de qualquer forma. Excluir uma coleção apaga de forma definitiva seus locais e seus arquivos importados. Os mapas que a mostravam continuam funcionando, sem ela.
Quando uma organização é excluída, as coleções dela são excluídas junto.
Limites
| Limite | Free | Pro | Enterprise |
|---|---|---|---|
| Coleções | 3 | 25 | Definido no seu contrato |
| Locais em uma coleção | 1000 | 25 000 | 100 000 |
| Locais em todas as coleções | 3000 | 250 000 | Definido no seu contrato |
| Atualização programada | Nenhuma: só Atualizar agora | No máximo diária | No máximo a cada hora |
| Tamanho de um arquivo, planilha ou feed | 32 MiB | 64 MiB | 64 MiB |
Em todos os planos, uma coleção tem no máximo 100 000 locais e 100 colunas, e uma célula no máximo 2000 caracteres. Um limite só impede trabalho novo: uma organização acima de um limite mantém o que já publicou.
Em um mapa publicado, as buscas de endereço e as rotas são limitadas, cada uma, a 20 por minuto para um visitante e a 2000 por dia para um mapa. Elas não contam para o seu uso do Kaleidr AI.