Assistência / O seu mapa / Imagens de satélite da Google Pesquisar na ajuda

Imagens de satélite da Google

O Yardstick desenha o seu jardim sobre uma fotografia aérea gratuita disponibilizada por entidades públicas. Se preferir a imagem da Google, que costuma ser mais nítida e recente, terá de fornecer a sua própria chave da Google. Este guia explica todo o processo, incluindo os dois pontos que costumam causar dificuldades.

Onde encontrar Definições › Imagens do mapa
Esta configuração é opcional A opção predefinida é USGS/NAIP: imagens de domínio público de todos os Estados Unidos, sem chave, sem conta e sem nada para configurar. Normalmente, têm um ou dois anos e uma resolução de cerca de 0,6 metros por píxel. São fotografias aéreas reais, não imagens provisórias. A Google é uma melhoria opcional, e nenhuma outra funcionalidade do Yardstick depende da opção escolhida.

Primeiro, a armadilha

A Google disponibiliza agora uma chave gratuita que não exige cartão de crédito, chamada Maps Demo Key. É mesmo gratuita e não funciona mesmo com o Yardstick. Quase toda a gente esbarra neste problema, pelo que vale a pena percebê-lo antes de começar.

O Yardstick usa a Map Tiles API para obter a fotografia nítida de alta resolução e a Maps Static API como alternativa. Ative ambas no projeto e autorize ambas na sua chave. A partir do Yardstick 1.1.10, uma chave que apenas permita Maps Static continua a apresentar uma fotografia de menor resolução. Por isso, a presença de uma fotografia não prova, por si só, que os mosaicos estejam ativados. Se a imagem ficar desfocada ao ampliar, verifique as APIs ativadas no projeto e as restrições de API da chave nos passos abaixo. A faturação tem de estar ativada no mesmo projeto da chave.

Se colar uma chave de demonstração no Yardstick, o mapa continua a mostrar a fotografia da USGS, sem qualquer alteração visível. O Yardstick informa que a chave não devolveu imagens, mas o que importa é o motivo pelo qual a Google a recusa. A solução é sempre a mesma: associar uma conta de faturação.

Guia passo a passo

  • Obter uma chave

    Aceda ao Google Maps Platform e comece por criar uma chave de demonstração. Nesta fase, não é necessário um cartão. É um bom ponto de partida, embora a chave ainda não funcione.

A página do Google Maps Platform com o título Comece a criar sem barreiras e um painel Maps Demo Key que mostra uma chave de API de exemplo e um botão Copiar chave.
Passo 1. A página Maps Demo Key da Google. A chave aqui apresentada é um exemplo da própria Google, não uma chave real.
  • Ler as letras pequenas e premir Atualizar conta

    A Google fornece a chave e, ao mesmo tempo, indica que o seu uso está limitado a testes. É por isso que a chave não permite apresentar o seu jardim. O link Atualizar conta ao lado é a solução.

Uma caixa de diálogo do Google Cloud com o título Aqui está a sua Maps Demo Key, a chave num campo, o texto «Esta chave está limitada à utilização em testes, mas pode atualizar quando estiver tudo pronto para produção» e um link Atualizar conta.
Passo 2. «Esta chave está limitada à utilização em testes.» É esse o problema, explicado pela própria Google. A chave nesta imagem foi entretanto eliminada.
  • Atualizar

    A Google explica o que muda: todas as suas APIs do Maps ficam disponíveis para o seu projeto, a chave existente continua a funcionar e a Google fatura consoante a utilização, com uma quota mensal gratuita. Consulte a secção de preços abaixo.

Uma caixa de diálogo da Google com o título Tudo pronto para lançar, que apresenta Aceda a todas as APIs GMP, Sem interrupções: mantenha a sua chave atual e Obtenha até 10k chamadas gratuitas por produto por mês, com os botões Fechar e Atualizar.
Passo 3. Repare em «Mantenha a sua chave atual». Não é necessário começar de novo.
  • Associar uma conta de faturação

    Se já tiver uma, selecione-a. Caso contrário, a Google orienta-o na criação de uma conta e pede um cartão. Não há forma de contornar este requisito: a Google exige faturação em qualquer projeto que use as imagens de que o Yardstick precisa. A Google fatura consoante a utilização; consulte a secção de preços abaixo.

Uma caixa de diálogo da Google com o título Definir a conta de faturação do projeto, uma lista pendente Conta de faturação e um botão Definir conta.
Passo 4. Escolher a conta de faturação. Para criar uma a partir daqui, basta passar por mais alguns ecrãs e fornecer um cartão.
  • Deixar a Google ativar as APIs

    Quando a atualização termina, a Google volta a mostrar a sua chave com a opção Ativar todas as APIs do Google Maps para este projeto já selecionada. Deixe-a selecionada. É esta opção que ativa tanto a Maps Static API como a Map Tiles API, evitando ter de as procurar na consola.

Uma caixa de diálogo da Google com o título Tudo pronto para desenvolver, que mostra a chave de API atualizada e uma caixa de verificação selecionada com o texto Ativar todas as APIs do Google Maps para este projeto.
Passo 5. Deixe a opção selecionada. A chave aqui apresentada foi entretanto eliminada.
  • Colar a chave no Yardstick

    Abra Definições, procure Imagens do mapa, defina a origem como Google, cole a chave e prima Guardar. Em seguida, recarregue a página do mapa.

Um pormenor nas versões mais antigas Até à versão 1.0.5, inclusive, o Yardstick guarda a chave corretamente, mas a instância em execução só a reconhece depois de reiniciar. Se o mapa continuar a mostrar a fotografia da USGS depois de guardar, reinicie o Yardstick ou o computador e volte a verificar. No Yardstick 1.1.10, guarde a chave e recarregue o mapa.

Se tiver aplicado restrições à sua chave

Aplicar restrições a uma chave é uma boa prática, e o Yardstick funciona com uma chave com restrições, desde que estas permitam ambas as APIs. A partir do Yardstick 1.1.10, uma chave limitada à Maps Static API apresenta uma fotografia alternativa de menor resolução.

  • Ativar a Map Tiles API

    Na consola do Google Cloud, abra APIs & Serviços, depois Biblioteca, procure Map Tiles API e prima Ativar. Use o mesmo projeto da sua chave.

  • Adicionar às restrições de API da chave

    Aceda a APIs & Serviços, depois a Credenciais, e abra a sua chave. Em Restrições de API, confirme que tanto a Maps Static API como a Map Tiles API estão selecionadas e prima Guardar.

  • Manter a restrição de aplicação tal como está

    Pode restringir a chave ao seu endereço IP público: o Yardstick envia os pedidos à Google a partir do seu computador. Uma restrição a sites (referenciadores HTTP) não funciona e fará com que os pedidos sejam sempre recusados.

  • Aguardar alguns minutos e recarregar a página Resumo

    A Google pode demorar vários minutos a aplicar uma alteração a uma chave.

É necessária uma conta de faturação

É um requisito da Google. A própria documentação das imagens que o Yardstick usa indica-o claramente: "Para usar a Maps Static API, tem de ativar a faturação em cada um dos seus projetos e incluir uma chave de API ou um token OAuth em todos os pedidos de API ou SDK."

Não há forma de contornar este requisito, nem mesmo com a chave de demonstração gratuita. Se ainda não tiver uma conta de faturação, o passo Atualizar acima permite criar uma e exige um cartão.

Quanto custa: utilização e quota gratuita

A Google fatura consoante a utilização, com uma quota mensal gratuita para cada API. A sua utilização e as APIs usadas determinam se terá de pagar.

A medição anterior dizia respeito a uma propriedade que usava imagens aéreas guardadas: 20 imagens em 37 dias. Não permite prever a utilização da Map Tiles API nem a fatura de outra propriedade. O Yardstick mantém as imagens aéreas descarregadas no seu computador e reutiliza-as enquanto a cópia guardada for adequada. Map Tiles e Maps Static são serviços distintos, pelo que deve contabilizar a utilização de cada um separadamente ao verificar o seu projeto no Google Cloud.

O cálculo anterior, baseado numa nova imagem a cada quatro minutos e meio, dizia respeito apenas às imagens Static. Não permite concluir que a utilização dos mosaicos se mantém dentro da respetiva quota. Verifique ambas as APIs no Google Cloud, incluindo quaisquer outras aplicações que usem a mesma conta de faturação.

Se ultrapassar a quota

Os custos acima da quota dependem da API e do escalão de utilização. As imagens Maps Static e os pedidos Map Tiles têm unidades de faturação e limites gratuitos diferentes. Consulte ambos na página de preços da Google e acompanhe a utilização do seu projeto, em vez de considerar o preço das imagens Static como o preço de todo o mapa.

Estes são os preços da Google e a Google pode alterá-los. O preço em vigor está sempre na sua página de preços.

Se o mapa continuar a mostrar imagens USGS

  • Reinicie primeiro o Yardstick

    Na versão 1.0.5 e anteriores, uma chave guardada só é utilizada depois de reiniciar o Yardstick. Se ainda utiliza essa versão mais antiga, reiniciar é uma boa primeira verificação. No Yardstick 1.1.10, guarde a chave e volte a carregar o mapa.

  • Verifique se a chave está associada a uma conta de faturação

    Uma chave de demonstração nunca funcionará. Se ainda não concluiu o passo Upgrade, essa é a explicação.

  • Aguarde alguns minutos

    A Google pode demorar vários minutos a começar a responder através de uma API recém-ativada. Já vimos a mesma chave recusar um pedido e responder-lhe perfeitamente vinte minutos depois, sem qualquer alteração pelo meio.

  • Verifique se a chave não tem restrições por site

    O Yardstick faz os pedidos à Google a partir do seu computador, não de uma página Web. Uma chave restrita a referenciadores HTTP será sempre recusada.

  • A foto fica desfocada ao ampliar?

    A chave tem autorização para utilizar a Maps Static API, mas não a Map Tiles API. Consulte Se restringiu a sua chave acima.

  • Ainda não conseguiu resolver? Envie-nos o registo

    Em Definições → Apoio → Algo correu mal?, prima Enviar diagnóstico para o Yardstick. Basta um clique. O diagnóstico indica-nos a que fonte foram pedidas imagens, qual respondeu e se existe uma chave guardada. A sua chave nunca é incluída.

Verifique se a Map Tiles API está ativada

Três formas de o confirmar, tanto na Google como no Yardstick.

  • No Google Cloud: está ativada?

    Na consola do Google Cloud, abra APIs & Serviços e depois APIs & serviços ativados. A Map Tiles API deve constar da lista, junto da Maps Static API. Se não constar, ative-a na Biblioteca.

  • No Google Cloud: a chave tem autorização para a utilizar?

    Abra APIs & Serviços, depois Credenciais e clique na sua chave. Se Restrições de API estiver definido como Restringir chave, tanto a Maps Static API como a Map Tiles API têm de constar da lista selecionada. A opção Não restringir chave também funciona.

  • No Yardstick: a imagem mantém-se nítida na página Resumo?

    Abra a página Resumo e amplie o seu jardim. Se os mosaicos estiverem a funcionar, a foto mantém-se nítida ao ampliar e a linha de créditos da Google aparece por baixo do mapa. A partir do Yardstick 1.1.10, uma chave com acesso apenas à Maps Static API apresenta uma única foto alternativa, menos nítida.

  • No Yardstick: leia a resposta da Google

    Em Definições, na secção Imagens do mapa, ative Depuração do mapa (apenas se o apoio solicitar), prima Guardar e volte a carregar a página Resumo. Desative a opção depois de ler a informação; destina-se ao apoio técnico e deixa um painel por baixo do mapa. Esse painel inclui uma linha tiles: on significa que a Google está a fornecer mosaicos; refused é seguido do motivo indicado pela própria Google, como "Esta chave de API não está autorizada a utilizar este serviço ou API." A mesma linha consta do relatório enviado através de Enviar diagnóstico para o Yardstick.

O Yardstick é uma ferramenta independente para robôs Yarbo. Não é afiliado da Yarbo Inc. nem conta com o seu aval. · © 2026 Yardstick Technologies LLC.