Quando uma consulta de altitude retorna um número como 463 metros, é tentador interpretá-lo como a altura exata da coordenada precisa que você enviou, medida ao metro. O que ele realmente representa se parece mais com uma amostra de uma grade, em que cada célula cobre uma área definida no solo e o valor armazenado descreve a altitude em algum ponto dentro dessa célula, ou representativo dela, e não necessariamente a sua latitude e longitude exatas ao centímetro.
É isso que a resolução, expressa em metros por amostra, está dizendo. Uma resolução mais fina significa células menores e um valor que acompanha mais de perto o seu ponto exato. Uma resolução mais grosseira significa que cada amostra cobre mais terreno, e a altitude real na sua coordenada específica pode diferir de forma significativa do valor armazenado se o terreno dentro daquela célula não for plano. Em uma planície, uma grade grosseira e uma grade fina vão concordar bastante, porque há pouca variação para a resolução deixar escapar. Em uma encosta, a mesma grade grosseira pode suavizar mudanças reais de altura que ocorrem dentro de uma única célula.
Isso importa mais em dois tipos de casos de uso. Se você está calculando algo como a direção de drenagem, a bacia visual ou a altura exata acima do nível do mar para fins de engenharia, a resolução é crítica e você deve confirmar os metros por amostra informados em relação ao que seu cálculo realmente precisa. Se você está fazendo algo mais grosseiro, como indicar se uma região é em geral montanhosa ou costeira, ou estimar a altitude aproximada de uma área grande, a resolução importa muito menos e uma grade padrão vai atendê-lo bem.
Também vale lembrar que os valores de altitude, venham de onde vierem, descrevem a altura da superfície, que nem sempre é o mesmo que o nível do solo em sentido estrito. Dependendo dos dados de base, um valor pode refletir o topo da copa das árvores ou de um prédio, e não a terra nua por baixo, principalmente em células urbanas densas ou de floresta. Dados opcionais de altitude do terreno, quando separam a superfície de terra nua do que está sobre ela, são úteis especificamente quando essa distinção importa para o seu cálculo, já que nem todo caso de uso precisa disso.
A consulta de altitude do My Geocode retorna metros acima do nível do mar para um único ponto ou uma lista de pontos, com a resolução informada, para que você saiba exatamente quanto terreno cada amostra representa antes de construir lógica em cima do número.
Um endereço no centro de uma cidade bem mapeada quase não diz nada sobre como o seu sistema lida com uma estrada rural, uma fronteira disputada ou uma consulta perto dos polos. Teste os casos difíceis de propósito.
Nem todo conjunto de dados com informações de localização de aparência pública pode ser usado legalmente dentro de um produto pago. Os termos de licenciamento, e não a disponibilidade técnica, costumam definir o limite real.
Quando uma consulta realmente não pode ser resolvida de forma confiável, não retornar nada é uma resposta melhor do que retornar um palpite disfarçado de fato. Veja o raciocínio por trás dessa escolha.