---
title: "Product update: novas variáveis ​​de localização para segmentações mais rica"
slug: "variaveis-localizacao"
locale: "pt-br"
description: "Acabamos de lançar uma grande atualização nas nossas variáveis de localização, tornando-as mais estruturadas, detalhadas e versáteis para segmentação e personalização com base em localização."
published_at: "2025-05-28"
updated_at: "2025-06-03"
image: "https://storage.googleapis.com/croct-assets-b931d070/blog/Variaveis_de_localizacao_2a42c69b31/Variaveis_de_localizacao_2a42c69b31.png"
authors: ["Juliana Amorim"]
category: "Novidades"
tags: ["Segmentação","Localização","Changelog"]
canonical: "https://blog.croct.com/pt-br/post/variaveis-localizacao"
---

# Product update: novas variáveis ​​de localização para segmentações mais rica

Experiências efetivas começam com contextos ricos e precisos, e a geolocalização tem um papel fundamental nisso. Pensando nisso, acabamos de lançar uma grande atualização nas nossas variáveis de localização, tornando-as mais estruturadas, detalhadas e versáteis para segmentação e personalização com base em localização.

## O que mudou?

Descontinuamos a variável `location's district` e padronizamos como as propriedades são estruturadas para torná-las mais expressivas e intuitivas de usar. Essa mudança permite acessar dados mais granulares, incluindo o nome e o código de cada região, e abre portas para novas variáveis no futuro.

### Continente

A estrutura desta variável mudou e agora temos novos aliases:

- `location's continent` agora é um objeto com nome e código, em vez de uma string
- Agora você deve usar `location's continent's name` ou `location's continentName`
- Além de `location's continentCode` existente, agora você também pode usar `location's continent's code`

### Estado ou região

A estrutura desta variável mudou e agora temos novos aliases:

- `location's state` agora é um objeto com nome e código, em vez de uma string
- Agora você deve usar `location's state's name` ou `location's stateName`
- Além de `locations stateCode` existente, agora você também pode usar `location's state's code`

Como `state` é um alias para `region`, você pode escolher sua notação preferida.

### Cidade

A estrutura desta variável mudou e agora temos um novo alias. Em vez de uma string, `location's city` agora é um objeto com um nome, então agora você deve usar `location's city's name` ou `location's cityName`.

## Novas variáveis de localização

Estamos adicionando novas variáveis para possibilitar segmentações ainda mais ricas.

### Coordenadas geográficas

Quando disponível, você terá informações de localização precisas para latitude e longitude:

```cql noLineNumber
location's coordinates' latitude     // 36.7783
location's coordinates' longitude    // 119.4179
```

Latitude negativa significa sul, latitude positiva significa norte, longitude negativa significa oeste e longitude positiva significa leste. Portanto, para segmentar as pessoas dos hemisférios norte e ocidental, você deve usar:

```cql noLineNumber
location's coordinates' latitude is greater than 0
and
location's coordinates' longitude is less than 0
```

### Moeda

Saber qual é a moeda local dos seus usuários para exibir preços ou condições de pagamento é extremamente importante. Agora, isso é tão fácil quanto:

```cql noLineNumber
location's currency's name    // "US Dollar"
location's currency's code    // "USD"
```

### Código de telefone

Se você trabalha em negócios B2B, provavelmente está acostumado com formulários de contato e vendas. Para [inputsa de número de telefone](https://croct.com/templates/interface/form/react-phone-number-input), agora você pode detectar automaticamente a localização do usuário e preencher o código do país e a formatação apropriados.

```cql noLineNumber
location's phoneCode    // "+1"
```

### Idiomas

Compreender os idiomas locais dos seus usuários é tão fácil quanto:

```cql noLineNumber
location's languages    // ["en-ca", "fr-ca"]
```

### Elevação e população

Crie experiências com base em características geográficas:

```cql noLineNumber
location's elevation     // 1500
location's population    // 100000
```

### Código postal

Útil para promoções regionais ou lógicas de entrega e frete:

```cql noLineNumber
location's postalCode    // "90210"
```

## Novas tags de localização

Esta é a maior atualização desso lançamento! Tags semânticas descrevem o tipo de local em que o usuário está, tornando a segmentação mais fácil do que nunca.

Em vez de lidar com lógicas geográficas complexas, agora você pode utilizar estas tags:

- **Local:** urban, residential, rural, remote, park, island
- **Sociedade:** government, politics, military, religion, education
- **Economia:** business, industry, agriculture
- **Infraestrutura:** transport, facility, waterway, airport, road, railway, seaport
- **Esporte:** fishing, surfing, swimming, hiking, skiing
- **Atração:** entertainment, scenery, landmark, recreation, tourism
- **Natureza:** mountain, lake, river, canyon, desert, ocean, coast, beach, forest
- **Clima:** warm, cold, snowy

Se você trabalha em um e-commerce, por exemplo, e quer segmentar usuários na praia, agora isso é tão simples quanto:

```cql noLineNumber
"beach" is in location's tags
location's tags include "beach"
```

> 💬 GeoNames
>
> As informações de localização são baseadas em dados de [GeoNames](https://www.geonames.org), uma base de dados geográfica global e gratuita utilizada por empresas como Apple, Microsoft, Accenture, BBC, New York Times e outras. As tags são categorizadas por meio de seus [códigos de feature](https://www.geonames.org/export/codes.html), o que significa que a Croct não tem controle sobre quais tags são atribuídas.

## Pronto pra testar?

Essas novas variáveis já estão disponíveis para todas as contas Croct, inlusive no plano gratuito!

Se você estiver pensando oferecer [experiências baseadas em localização](/post/location-playbook.md), [otimizar formulários](https://croct.com/templates/interface/form/react-phone-number-input) ou rodar testes AB para uma locaização específica, aproveite essas novas funcionadades hoje mesmo!

E se quiser explorar todas as novas variáveis e expressões, confira a nossa [documentação](https://docs.croct.com/reference/cql/context#location) atualizada :)