Geolocalização é o cadastro das localizações de entrega a partir da latitude e longitude dos endereços. Por meio dela, podemos montar polígonos para um atendimento logístico específico, normalmente utilizado em zonas rurais e industriais, onde há divisão por lotes, por exemplo, ou em áreas de risco, onde se faz necessário excluir determinados locais dentro de uma mesma região.

Sua estruturação é dinâmica. A região a ser delimitada pode ser fácil e literalmente desenhada no mapa. O polígono criado será usado na planilha de frete que é cadastrada na transportadora.

Acessando o link Gere seus polígonos com geojson.io, aparecerá o mapa onde é possível desenhar a área que sua loja deseja atender. À medida que o desenho do polígono é feito, a tela da direita exibe o código JSON correspondente à área desenhada. É através desse código JSON que o sistema entenderá o local de entrega.

1. No Admin VTEX, acesse Configurações da loja > Envio > Envio por geolocalização, ou digite Geolocalização na barra de busca no topo da página.
2. Clique no link Gere seus polígonos com geojson.io.
3. Encontre no mapa a região em que será feita a entrega.
4. Selecione a opção Draw a polygon ou Draw a rectangle. Essas opções ficam abaixo da lupa, no lado direito do mapa.
5. Clique no mapa no local onde deseja que fique o primeiro ponto do polígono, e continue clicando para desenhar a área, de forma que a última linha encontre o primeiro ponto.
6. Com o polígono pronto, copie o JSON que fica na tela da direita e guarde-o em um arquivo.

Esse JSON será usado para adicionar o polígono na plataforma, que entenderá a partir dessa linguagem quais códigos postais estão inclusos nessa área.

Na configuração de um polígono, não é possível delimitar áreas sobrepostas, ou seja, não é possível sobrepor coordenadas geográficas.

Ao adicionar um polígono, é preciso nomeá-lo, de modo que ele seja identificado na planilha de frete, para que depois possa ser consultado por meio do código postal.

1. No Admin VTEX, acesse Configurações da loja > Envio > Envio por geolocalização, ou digite Geolocalização na barra de busca no topo da página.
2. Clique no botão Adicionar novo Polígono.
3. Digite no campo ID qualquer informação em formato de string (letra ou número) sem espaço, de forma que ela identifique o polígono e a área que ele atende. Exemplo: ZonaLeste1.
4. Em coordenadas, cole o JSON copiado no passo anterior, a partir do segundo colchete depois do item coordinates, de forma que no início do código existam dois colchetes, assim como no final. Veja o exemplo abaixo.
5. Clique no botão Salvar.

Exemplo:

Pronto, agora é só usar esse mesmo ID para preencher a coluna PolygonName da planilha de frete.

É importante atentar para o fato de que, no caso de você usar geolocalização, preenchendo portanto a coluna PolygonName da planilha de frete, a transportadora em questão não usará as colunas ZipCodeStart e ZipCodeEnd, que deverão ser preenchidas com 0.

Lembre-se também que para que a geolocalização funcione, deve estar preenchido o campo API Key em Configurações da loja > Storefront > Checkout, na aba Checkout, com a mesma chave que utilizou para habilitar a geolocalização.

Habilite também todas as APIs do Google Cloud Platform para garantir o funcionamento da chave:

• Geocoding API
• Places API
• Maps JavaScript API

Caso precise alterar algum local de entrega de um polígono já existente, é possível editá-lo. Para isso, siga os passos abaixo.

1. No Admin VTEX, acesse Configurações da loja > Envio > Envio por geolocalização, ou digite Geolocalização na barra de busca no topo da página.
2. Clique em Editar no polígono desejado.
3. Clique no link Gere seus polígonos com geojson.io.
4. Refaça o desenho no mapa.
5. Copie as coordenadas.
6. Clique no link Alterar Coordenadas, que fica logo abaixo do campo de Coordenadas.
7. Cole os novos valores.
8. Clique no botão Salvar.

Depois disso, não será necessário alterar nenhuma informação na planilha de frete, visto que o ID do polígono continua o mesmo, e é por meio dele que o sistema faz a consulta.

Caso a transportadora e planilha de frete tenham sido criadas antes de cadastrar o Polígono, recomendamos que seja editada a transportadora que tem vínculo com esse Polígono, para atualizar o relacionamento. Com isso após a Criação ou Alteração de um Poligono, abra a transportadora e clique em Salvar, somente para sensibilizar uma atualização.