> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Nova função da IA: Busca de Entorno

> A Mia responde sobre o entorno do empreendimento consultando o Google Maps em tempo real — sem cadastro manual.

A integração com a API do Google Maps permite que a Mia responda perguntas geográficas sobre o entorno do empreendimento — escolas, comércios, hospitais, transporte público — consultando o mapa em tempo real e salvando o conhecimento para reuso.

<Tip>
  Skill multi-agente — disponível para **Mia** (pré-venda: lead avalia o bairro antes da visita) e **Iago** (pós-venda: cliente já morador pergunta sobre serviços novos no entorno).
</Tip>

## O que é?

Skill que conecta a Morada à API do Google Maps. Quando o lead pergunta algo geográfico ("tem escola perto?", "quanto tempo até o shopping?", "qual o hospital mais próximo?"), a IA consulta o mapa com o endereço do empreendimento, responde com o nome do local e a distância real, e salva o dado.

## Como funciona

<Steps>
  <Step title="Lead faz pergunta geográfica">
    "Tem escola perto?", "Qual o shopping mais próximo?", "Tem academia no bairro?".
  </Step>

  <Step title="Mia detecta intenção">
    A IA identifica a categoria (escola, lazer, transporte etc.) e consulta a API do Google Maps com o endereço do empreendimento.
  </Step>

  <Step title="Resposta com dados reais">
    A Mia responde com o nome do local, distância e tempo de deslocamento.
  </Step>

  <Step title="Conhecimento salvo">
    O dado fica gravado no empreendimento. A próxima pergunta sobre o mesmo local é instantânea.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/mia/googlemaps-conversa.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=d71d2d02cba5590c8e3fa3414a2d1870" alt="Conversa no WhatsApp com a Mia respondendo sobre escolas e supermercados próximos ao empreendimento, com nome, distância e tempo a pé" className="mx-auto" style={{ width:"50%" }} width="1140" height="2400" data-path="images/mia/googlemaps-conversa.png" />
</Frame>

## Categorias suportadas

| Categoria  | Exemplos                       |
| ---------- | ------------------------------ |
| Educação   | Escolas, faculdades, creches   |
| Saúde      | Hospitais, farmácias, clínicas |
| Transporte | Metrô, ônibus, terminais       |
| Comércio   | Mercados, shoppings, lojas     |
| Lazer      | Parques, restaurantes, cinemas |
| Serviços   | Bancos, correios, academias    |

## Benefícios

* **Cobertura infinita do entorno.** A IA descobre conforme o lead pergunta — sem cadastrar nada na Biblioteca.
* **Memória do empreendimento.** O conhecimento acumulado vira ativo do empreendimento.
* **Reduz objeções de localização.** Lead em dúvida sobre infraestrutura recebe resposta factual em segundos.
* **Encanta o lead.** Informação que normalmente exigiria Google manual chega pronta na conversa.

## Quando ativar

* Empreendimento em bairro novo ou em desenvolvimento — leads sempre perguntam sobre infraestrutura.
* Público com filhos (muita pergunta sobre escolas).
* Operação que cansa de cadastrar pontos de interesse manualmente na Biblioteca.
* Cliente quer "uau" de demonstração — esse recurso costuma surpreender em reunião.

## Como ativar

<Steps>
  <Step title="Solicite ativação">
    A integração com o Google Maps é habilitada por workspace. Solicite ao seu CSM ou abra ticket via Iago Suporte.
  </Step>

  <Step title="Verifique os endereços dos empreendimentos">
    Em **Empreendimentos**, confira se cada empreendimento tem endereço completo cadastrado — a precisão da resposta depende disso.
  </Step>

  <Step title="Configure as categorias do entorno">
    Em **Empreendimentos → Informações do entorno na conversa**, ative a feature e selecione quais categorias a IA pode mencionar: **Educação**, **Saúde**, **Transporte**, **Comércio**, **Lazer** e **Serviços**. Use **Buscar agora** para pré-carregar os locais e revisar antes de liberar para os leads.

    <Frame>
      <img src="https://mintcdn.com/moradaai-f7bfc739/JRWzsJdZRQ7PfNtQ/images/mia/googlemaps-plataforma.png?fit=max&auto=format&n=JRWzsJdZRQ7PfNtQ&q=85&s=a810357f993534d64a814e7959738dcc" alt="Tela &#x22;Informações do entorno na conversa&#x22; com categorias selecionáveis e resultados encontrados por categoria via Google Maps" width="1676" height="816" data-path="images/mia/googlemaps-plataforma.png" />
    </Frame>
  </Step>

  <Step title="Teste em sandbox">
    Faça perguntas geográficas em um número de teste para validar o comportamento antes da ativação geral.
  </Step>
</Steps>

***

## FAQ

<AccordionGroup>
  <Accordion title="A Mia mente sobre lugares que não existem?">
    Não. A IA só responde com base no que o Google Maps retorna. Se a busca não tem resultado relevante, a Mia avisa que não tem essa informação.
  </Accordion>

  <Accordion title="Funciona para qualquer empreendimento?">
    Funciona para qualquer empreendimento com endereço cadastrado corretamente. Se o endereço estiver incompleto ou impreciso, a resposta perde qualidade.
  </Accordion>

  <Accordion title="A Mia consegue calcular trânsito ao vivo?">
    A consulta retorna tempo de deslocamento estimado pelo Google. Em horários de pico, o tempo pode variar — a IA esclarece isso na resposta.
  </Accordion>

  <Accordion title="Posso desativar a integração para um empreendimento específico?">
    Sim. A configuração é por empreendimento.
  </Accordion>
</AccordionGroup>