{"section":"tutorials","requestedLocale":"pt","requestedSlug":"geolocalizacao-no-checkout","locale":"pt","slug":"geolocalizacao-no-checkout","path":"docs/pt/tutorials/checkout/configurações-do-checkout/geolocalizacao-no-checkout.md","branch":"main","content":"O objetivo deste tutorial é ensinar os passos necessários para utilizar a geolocalização no checkout da sua loja. \n\nPor meio desta funcionalidade, é possível fazer com que as entregas usem como base um ponto geográfico (latitude e longitude) em vez de um código postal.\n\n### Como isso melhora a minha loja?\n\nA funcionalidade de geolocalização permite ao seu cliente a autogestão na busca pelo endereço de entrega desejado. \n\nOu seja, no momento do checkout, ele tem à disposição uma ferramenta com a habilidade de geolocalizar endereços do Google Maps com um ícone marcador de posição num mapa. \n\nIsto dá ao usuário a segurança visual de que o pedido chegará ao local que ele escolheu. As informações de localização se completarão automaticamente assim que o ponto seja carregado no mapa.\n\nEssa funcionalidade é especialmente útil em regiões com uma estrutura de códigos postais mal-definida.\n\n### Configurando a logística\n\nPara utilizar essa funcionalidade, siga os passos abaixo.\n\nAntes de mais nada, é necessário obter uma Javascript API Key do Google Maps que permita a integração com o serviço de geolocalização do Google. Você pode ler mais sobre como obtê-la em:\n\n[https://developers.google.com/maps/documentation/javascript/get-api-key](https://developers.google.com/maps/documentation/javascript/get-api-key)\n\nCom a API Key em mãos, siga os passos abaixo:\n\n1. No Admin VTEX, acesse __Configurações da loja > Envio > Envio por geolocalização__, ou digite __Envio por geolocalização__ na barra de busca no topo da página.\n2. Insira a API Key no campo disponível e clique em __Cadastrar chave__.\n\n![Geolocalizacao 1 PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/checkout/configurações-do-checkout/geolocalizacao-no-checkout_1.png)\n\n> ℹ️ Em alguns países, o Google Maps não realiza um mapping de alta qualidade. Com isso, pode acontecer de certos endereços serem mal escritos ou de o Google indicar um endereço incorreto. Nestes casos, deve-se corrigir o endereço diretamente no mapa.\n\n### Configurando o polígono\n\nPara que essa funcionalidade trabalhe corretamente, é necessário cadastrar os polígonos correspondentes às áreas de entrega desejadas no mapa. \n\nEm seguida, deve-se associá-los às transportadoras que farão as entregas, por meio da inclusão dos IDs desses polígonos na tabela de frete. Saiba como fazer isso no artigo [Cadastrando geolocalização](/pt/docs/tutorials/gerenciar-geolocalizacao/).\n\n### Configurando o Checkout\n\nApós criar o polígono e inserir seu ID na planilha de frete, você precisará inserir a API Key do Google nas configurações do Checkout:\n\n1. No Admin VTEX, acesse __Configurações da loja > Storefront > Checkout__, ou digite __Checkout__ na barra de busca no topo da página.\n2. Clique no ícone <i class=\"fas fa-cog\" alt=\"engrenagem azul\"></i> do site desejado.\n3. No menu de opções azul localizado na parte superior da página, clique em __Checkout__.\n4. No campo __Google Maps API Key__, insira a mesma API Key informada na etapa de logística.\n\n![Google map keys](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/checkout/configurações-do-checkout/geolocalizacao-no-checkout_2.PNG)\n\nAssim que a API Key for informada nas configurações do Checkout, a geolocalização já estará visível no checkout da sua loja.\n\n### Como funciona a consulta do frete?\n\nCom a geolocalização ativada no checkout, o cálculo do frete sempre dará prioridade para esse recurso, usando os polígonos que englobam as coordenadas do destino selecionado. \n\nPortanto, mesmo que seu cliente queira usar o CEP, a geolocalização vai ter a preferência do sistema na hora de simular o valor da entrega."}