Perguntas frequentes
Respostas curtas às perguntas que mais recebemos. Se a sua não estiver aqui, pergunte.
Primeiros passos
Preciso de uma chave de API ou de uma conta para experimentar?
Não. Qualquer endereço tem 2.500 requisições por dia sem chave e sem conta, em todos os endpoints e em todos os hosts compatíveis. Cadastre-se (seu nome, um endereço de e-mail e uma senha) quando quiser chaves próprias, um histórico de uso, crédito pré-pago ou um pacote Unlimited. Requisições feitas sem chave e requisições feitas com chave da mesma rede compartilham uma única cota diária, então uma conta não dobra as 2.500 gratuitas.
O que preciso para me cadastrar?
O seu nome, um endereço de e-mail e uma senha. Nada mais: nem empresa, nem cartão. Você pode criar mais chaves na hora e adicionar crédito ou um pacote quando decidir.
Como funciona o crédito?
Você recarrega um saldo antecipadamente, qualquer valor a partir de € 5, com cartão ou em criptomoeda. Cada requisição acima das 2.500 gratuitas do dia de uma chave desconta € 0,0001 desse saldo. O crédito é compartilhado por todas as suas chaves de pagamento por uso, nunca expira, e nada é cobrado automaticamente. Quando ele acaba, as requisições acima da cota gratuita são recusadas com 402 até você recarregar.
Como vocês recebem pagamentos?
Com cartão pela Polar, ou em criptomoeda pela NOWPayments: Bitcoin, Ethereum, USDT, USDC, Litecoin e muitas outras. O valor é fixado no checkout e aplicado assim que o pagamento é confirmado. Todos os preços são em euros.
O que o pacote Unlimited inclui?
Uma chave sem cobrança por requisição em todos os endpoints e em todos os hosts compatíveis, por € 50 por mês, utilizável a partir de até três endereços IP a cada 24 horas móveis. Cada pacote tem a sua própria chave; contrate vários se você tiver várias aplicações. Veja os preços.
Existe um programa de indicação?
Sim. O seu painel tem um link de indicação; 10% de cada fatura paga por alguém que se cadastrou por ele vai para um saldo de indicação mantido separado do seu crédito. Transfira-o para o crédito quando quiser, ou saque-o em criptomoeda a partir de € 20. Os saques são processados manualmente, e o ID da transação aparece no seu painel.
Vocês têm códigos de cupom?
Às vezes: descontos percentuais ou fixos numa recarga ou num pacote, ou crédito bônus. Informe um código ao criar a fatura ou em qualquer fatura não paga antes de pagar.
Acesso e limites
Como a cota gratuita é contada?
Por chave, por dia UTC, em todos os endpoints e hosts compatíveis. Consultas de IP em lote e chamadas de altitude com vários pontos contam uma por item. Requisições recusadas e erros de servidor nunca são contados.
O que significa o limite de IP?
Os primeiros endereços a usar uma chave ocupam, cada um, uma vaga por 24 horas a partir da sua primeira requisição. Uma chave de pagamento por uso tem duas vagas, uma chave Unlimited tem três. Quando as 24 horas de uma vaga terminam, ela é liberada sozinha; assim, se dois servidores usaram a chave às 02:00 e um terceiro às 04:00, duas vagas ficam livres de novo às 02:00 do dia seguinte e a terceira às 04:00. Uma requisição de um endereço novo enquanto todas as vagas estão ocupadas é recusada com HTTP 403 e o código key_ip_limit; a resposta informa quando a próxima vaga será liberada. Para mais máquinas, crie mais chaves ou adicione mais pacotes.
Posso chamar a API a partir de um navegador ou de um app móvel?
O CORS está ativado, mas uma chave no código do cliente fica visível para todos e atingiria o seu limite de IP depois de alguns visitantes. Chame a API a partir do seu próprio servidor e coloque a chave lá. O mesmo vale para os drop-ins de mapas em JavaScript: tiles e carregamentos de biblioteca não precisam de chave, e as chamadas de geocodificação devem passar pelo seu servidor.
Existe um limite de taxa além da cota diária?
Hoje não há um limite fixo. Tráfego que pareça um loop descontrolado ou um ataque pode ser desacelerado, e avisaremos você se isso acontecer com uma das suas chaves. Os endpoints de lote existem para que você não precise de centenas de requisições por segundo.
O que acontece se a minha chave vazar?
Revogue-a no painel e crie uma nova. Por causa do limite de IP, uma chave vazada não pode ser usada a partir de mais de duas ou três máquinas por dia de qualquer forma, e, como o crédito é pré-pago, ninguém pode gerar uma conta acima do saldo que você decidiu carregar.
Dados e precisão
O que significa o campo precision?
Ele informa o que o ponto retornado representa: house para o edifício ou lote, street para uma posição interpolada ao longo da rua, postcode para o centro da área de um código postal e admin para o centro de uma cidade, distrito, região ou país. Se você pediu uma casa e recebeu postcode, não conseguimos encontrar a casa.
Quais países têm dados em nível de número de casa?
A página de cobertura lista o melhor nível disponível para cada um dos 249 países e territórios, com filtros por região e nível. Ela é atualizada a cada nova versão dos dados.
Quais fontes de dados vocês usam?
Dados oficiais de endereços e dados postais, dados de registro e roteamento da internet para as consultas de IP, o banco de dados padrão de fusos horários e modelos globais de terreno, além das nossas próprias correções. Cada fonte é conferida com as outras antes de entrar, e nada é extraído de outros serviços de geocodificação.
Posso armazenar ou colocar os resultados em cache?
Sim. Os resultados são seus para manter no seu banco de dados, colocar em cache e exibir em qualquer mapa, incluindo mapas de outros provedores. A única restrição nos termos é revender os dados brutos como um serviço de geocodificação próprio.
Com que frequência os dados são atualizados?
Os dados de endereços são atualizados mensalmente, os dados de IP semanalmente, as regras de fuso horário sempre que a IANA publica uma versão, e os dados de altitude quando surge um modelo público melhor.
Vocês suportam outros idiomas além do inglês?
Passe lang com um código ISO 639-1 e os nomes de lugares voltam nesse idioma quando os temos, com o nome local como alternativa. A formatação de endereços segue as convenções do país em que o endereço fica.
Compatibilidade
Os hosts compatíveis são cópias exatas das APIs originais?
Os caminhos, parâmetros e formatos de resposta correspondem à documentação pública de cada provedor, para que o código cliente existente processe as respostas sem alterações. Os dados são nossos, então os valores diferem, e alguns recursos específicos de cada provedor não estão incluídos. Cada página de compatibilidade lista as diferenças.
O drop-in do Google Maps JavaScript mostra os tiles de mapa do Google?
Não. O loader em gapi.mygeocode.com fornece o namespace google.maps com os nossos próprios tiles de mapa, geocodificador, preenchimento automático e serviço de altitude por trás. Street View, Directions e Places Details não estão incluídos. Carregamentos de mapa não contam para a sua cota. Veja drop-ins em JavaScript.
O My Geocode tem vínculo com Google, Microsoft, HERE ou Mapbox?
Não. Esses nomes pertencem aos seus donos e são usados aqui apenas para dizer em quais formatos podemos responder.
Suporte
Existe garantia de disponibilidade?
Os planos self-service não vêm com SLA contratual. Rodamos a API em mais de uma região e mostramos o status em tempo real em status.mygeocode.com. Se você precisa de um SLA por escrito, fale conosco.
Como obtenho suporte?
Envie um e-mail para support@mygeocode.com. Contas pagantes recebem resposta em até um dia útil. Perguntas de chaves gratuitas também são respondidas, conforme o tempo permitir.