Um Place é o resultado de uma busca externa de locais. Ele é usado para descoberta/geocodificação e alimenta a criação de Points no catálogo global.
Operações
Autocomplete
| Campo | Descrição |
|---|
query | Termo digitado pelo usuário |
sessionToken | Token opcional para agrupar uma sessão de busca |
| Campo da sugestão | Descrição |
|---|
placeId | Identificador do Google usado para resolver detalhes |
text | Texto completo da sugestão |
name | Nome principal |
description | Texto secundário/endereço |
Detalhes do local
| Campo | Descrição |
|---|
placeId | Identificador do local escolhido |
sessionToken | Mesmo token usado no autocomplete, quando informado |
placeId no formato pronto para semear um Point:
| Campo | Origem |
|---|
placeId | eco do identificador |
name | displayName → shortFormattedAddress → formattedAddress (primeiro não-vazio) |
description | formattedAddress quando presente e diferente de name; senão null |
lat / lng | coordenadas do local (obrigatórias no provedor) |
Fluxo de cadastro de Point
O sessionToken agrupa autocomplete e detalhe final em uma única sessão de cobrança do provider — informe o mesmo token durante todo o fluxo de seleção de um local.
Capacidade
Place é uma capacidade de BackOffice, usada na gestão do catálogo global de Points:
| Ação | Acesso |
|---|
| Autocomplete de locais | BackOffice — read:point |
| Detalhes do local escolhido | BackOffice — read:point |
A busca usa região br e idioma pt-BR. O Point resultante é salvo quando o operador cria o ponto.
