Monitore o uso da sua chave antes de atingir um limite
Acompanhar seus cabeçalhos de cota ao longo do caminho mostra quando um limite está se aproximando, bem antes de uma requisição ser realmente rejeitada.
Geocodifique endereços que incluem número de apartamento ou unidade
Um número de apartamento acrescentado a um endereço é uma parte normal de muitos endereços reais, e vale a pena entender como uma consulta de geocodificação lida com ele, em vez de removê-lo antes de enviar a requisição, um hábito comum, mas desnecessário.
Enviando o endereço completo
Inclua o número do apartamento ou da unidade como parte da consulta em texto livre, da mesma forma que qualquer outra parte do endereço.
GET /v1/forward?q=Apt 4B, 350 Fifth Avenue, New York&limit=1{
"status": "ok",
"query": "Apt 4B, 350 Fifth Avenue, New York",
"results": [
{
"formatted": "350 Fifth Avenue, New York, NY",
"lat": 40.7484,
"lon": -73.9857,
"type": "address",
"precision": "house",
"confidence": 0.95,
"place_id": "es234",
"components": {"house_number": "350", "street": "Fifth Avenue", "city": "New York", "region": "NY", "country": "US"}
}
]
}Por que o número da unidade não aparece nas coordenadas
As coordenadas de uma consulta de geocodificação identificam um prédio, e não uma unidade específica dentro dele, já que apartamentos individuais não têm uma localização mapeada própria como um prédio tem. Não se espera que a parte do apartamento ou da unidade de um endereço altere os valores de lat e lon, e a ausência dela no objeto components também é esperada, e não um sinal de que a entrada foi ignorada ou tratada incorretamente.
Um segundo exemplo: o número de uma sala em um prédio comercial
O mesmo padrão vale para um endereço comercial com número de sala ou de andar.
GET /v1/forward?q=Suite 200, 1 Example Plaza, Chicago&limit=1Um grande prédio de escritórios que abriga dezenas de empresas diferentes continua sendo geocodificado para um único conjunto de coordenadas do prédio, qualquer que seja a sala indicada na consulta, exatamente como acontece com um prédio residencial. Tudo o que distingue um ocupante de outro dentro desse prédio precisa ficar nos seus próprios registros, e não nas coordenadas.
Um erro comum a evitar
Não tente contornar a ausência do componente de unidade acrescentando-o você mesmo, depois, ao código postal ou a outro campo de componente, por exemplo escrevendo um código postal como "20500 Apt 4B". Isso corrompe um campo que outros sistemas, incluindo a sua própria validação e quaisquer consultas de endereço posteriores, esperam que contenha apenas um código postal real. Mantenha o número da unidade em um campo próprio, totalmente separado de todos os componentes geocodificados.
Armazenando o número da unidade separadamente
Em vez de incluir o número da unidade na string de endereço que você geocodifica toda vez, armazene-o como um campo próprio no seu modelo de dados, junto com o endereço geocodificado do prédio. Isso mantém a requisição de geocodificação focada no que realmente afeta o resultado, a localização do prédio, e ainda preserva a informação da unidade para etiquetas de entrega ou registros internos.
Quando isso importa para a entrega
Um entregador ou serviço postal precisa do número da unidade para a entrega em si, mesmo que ele não tenha tido nenhum papel nas coordenadas. Mantenha as duas informações, as coordenadas geocodificadas do prédio e o número da unidade armazenado separadamente, juntas no registro final de entrega, para que nada se perca no processo.
Um caso extremo que vale conhecer
Um único endereço de prédio pode abrigar um grande número de moradores ou ocupantes diferentes, todos compartilhando as mesmas coordenadas e o mesmo resultado de consulta de código postal. Se você compara o código postal de um cliente com um endereço geocodificado de forma direta, como explicado no guia de verificação cruzada de código postal, lembre-se de que essa relação de muitos para um entre unidades e um prédio é esperada e não é, por si só, sinal de um problema nos dados.
O custo não muda
Com ou sem número de apartamento ou de unidade no endereço, a consulta continua custando uma requisição, igual a qualquer outra chamada de geocodificação direta.
Incluir o número da unidade na consulta não causa problema, e removê-lo não é necessário para uma geocodificação precisa, embora separá-lo depois em um campo armazenado próprio mantenha seus dados mais limpos. Consulte a documentação de geocodificação direta para ver a lista completa de componentes.