A API de Recuperação de Dados de Localização de Geocodificação Reversa permite obter informações geográficas precisas e estruturadas a partir de coordenadas de latitude e longitude. Quando recebe uma localização, a API retorna múltiplos níveis de dados de endereço que permitem identificar com precisão tanto pontos específicos (como um endereço exato) quanto áreas mais amplas (como bairros, cidades ou condados)
A resposta inclui um campo formatted_address que representa o endereço completo em um formato legível por humanos. Os address_components também são fornecidos, detalhando cada elemento que compõe o endereço, incluindo número da rua (street_number), nome da rua (route), bairro (neighborhood), sublocalidade (sublocality), cidade (locality), condado (administrative_area_level_2), estado (administrative_area_level_1), país e código postal. Cada componente vem com seu nome longo e curto, juntamente com seu tipo correspondente, que é útil para classificação e visualização
Além disso, a API retorna coordenadas precisas no campo geometry.location, incluindo valores de latitude e longitude, juntamente com o location_type indicando o nível de precisão (por exemplo, “ROOFTOP,” “APPROXIMATE,” ou “GEOMETRIC_CENTER”). Uma viewport (área de exibição) também é fornecida para facilitar a representação geográfica em mapas
Em alguns casos, a resposta pode incluir vários resultados hierárquicos ou alternativos, permitindo o acesso a locais próximos, edifícios associados, interseções ou pontos de interesse relacionados. Códigos plus (plus_code) com variantes de compound_code e global_code também estão incluídos, que são úteis para representar locais sem um endereço formal
Esta API é ideal para aplicações de geolocalização, logística, serviços de entrega, análise de território, validação de endereços, visualização de mapas e sistemas de informação geográfica (SIG). Ela suporta múltiplos formatos e níveis de granularidade, adaptando-se tanto a necessidades precisas quanto a análises territoriais mais amplas
Em resumo, a API fornece dados completos, estruturados e confiáveis para converter coordenadas em informações geográficas que são compreensíveis e utilizáveis por sistemas modernos
Para usar este endpoint, você deve especificar uma latitude e uma longitude no parâmetro
Geocodificação reversa - Recursos do endpoint
| Objeto | Descrição |
|---|---|
latlng |
[Obrigatório] Enter coordinates |
{
"plus_code" :
{
"compound_code" : "P27Q+MCM New York, NY, USA",
"global_code" : "87G8P27Q+MCM"
},
"results" :
[
{
"address_components" :
[
{
"long_name" : "277",
"short_name" : "277",
"types" :
[
"street_number"
]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" :
[
"route"
]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" :
[
"neighborhood",
"political"
]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" :
[
"political",
"sublocality",
"sublocality_level_1"
]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" :
[
"postal_code"
]
}
],
"formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" :
{
"location" :
{
"lat" : 40.7142205,
"lng" : -73.9612903
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 40.71556948029149,
"lng" : -73.95994131970849
},
"southwest" :
{
"lat" : 40.7128715197085,
"lng" : -73.9626392802915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 40.7142498,
"longitude" : -73.9613696
}
}
],
"place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
"plus_code" :
{
"compound_code" : "P27Q+MF Brooklyn, NY, USA",
"global_code" : "87G8P27Q+MF"
},
"types" :
[
"street_address"
]
},
{
"address_components" :
[
{
"long_name" : "281",
"short_name" : "281",
"types" :
[
"street_number"
]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" :
[
"route"
]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" :
[
"neighborhood",
"political"
]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" :
[
"political",
"sublocality",
"sublocality_level_1"
]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" :
[
"postal_code"
]
},
{
"long_name" : "4230",
"short_name" : "4230",
"types" :
[
"postal_code_suffix"
]
}
],
"formatted_address" : "281 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" :
{
"bounds" :
{
"northeast" :
{
"lat" : 40.7142054,
"lng" : -73.9612142
},
"southwest" :
{
"lat" : 40.7140652,
"lng" : -73.9614433
}
},
"location" :
{
"lat" : 40.7141354,
"lng" : -73.9613287
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 40.71548428029149,
"lng" : -73.9599797697085
},
"southwest" :
{
"lat" : 40.7127863197085,
"lng" : -73.9626777302915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 40.7141769,
"longitude" : -73.9614164
}
}
],
"place_id" : "ChIJiYRKQWBZwokR10UtO7vMvr0",
"types" :
[
"premise",
"street_address"
]
},
{
"address_components" :
[
{
"long_name" : "277",
"short_name" : "277",
"types" :
[
"street_number"
]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" :
[
"route"
]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" :
[
"neighborhood",
"political"
]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" :
[
"political",
"sublocality",
"sublocality_level_1"
]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" :
[
"postal_code"
]
}
],
"formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" :
{
"location" :
{
"lat" : 40.7142205,
"lng" : -73.9612903
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 40.71556948029149,
"lng" : -73.95994131970849
},
"southwest" :
{
"lat" : 40.7128715197085,
"lng" : -73.9626392802915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 40.7142199,
"longitude" : -73.9613932
}
}
],
"place_id" : "ChIJIdIK_DJZwokRImC6xolwWOM",
"plus_code" :
{
"compound_code" : "P27Q+MF Brooklyn, NY, USA",
"global_code" : "87G8P27Q+MF"
},
"types" :
[
"establishment",
"food",
"point_of_interest",
"restaurant"
]
},
{
"address_components" :
[
{
"long_name" : "294"}]}],"_note":"Response truncated for documentation purposes"}
curl --location --request GET 'https://zylalabs.com/api/9139/reverse+geocode+location+data+retrieval+api/16527/reverse+geocoding?latlng=40.714222,-73.961442' --header 'Authorization: Bearer YOUR_API_KEY'
Para usar este endpoint, você deve especificar um endereço no parâmetro
Geocodificação - Recursos do endpoint
| Objeto | Descrição |
|---|---|
address |
[Obrigatório] Indicate an address |
{
"results" :
[
{
"address_components" :
[
{
"long_name" : "Infinite Loop 1",
"short_name" : "Infinite Loop 1",
"types" :
[
"premise"
]
},
{
"long_name" : "1",
"short_name" : "1",
"types" :
[
"street_number"
]
},
{
"long_name" : "Infinite Loop",
"short_name" : "Infinite Loop",
"types" :
[
"route"
]
},
{
"long_name" : "Cupertino",
"short_name" : "Cupertino",
"types" :
[
"locality",
"political"
]
},
{
"long_name" : "Santa Clara County",
"short_name" : "Santa Clara County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "California",
"short_name" : "CA",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "95014",
"short_name" : "95014",
"types" :
[
"postal_code"
]
},
{
"long_name" : "2083",
"short_name" : "2083",
"types" :
[
"postal_code_suffix"
]
}
],
"formatted_address" : "Infinite Loop 1, 1 Infinite Loop, Cupertino, CA 95014, USA",
"geometry" :
{
"bounds" :
{
"northeast" :
{
"lat" : 37.3321786,
"lng" : -122.0297996
},
"southwest" :
{
"lat" : 37.3312158,
"lng" : -122.0305776
}
},
"location" :
{
"lat" : 37.3318598,
"lng" : -122.0302485
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 37.3330203302915,
"lng" : -122.0289492197085
},
"southwest" :
{
"lat" : 37.3303223697085,
"lng" : -122.0316471802915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 37.33116529999999,
"longitude" : -122.0307429
},
"restricted_travel_modes" :
[
"WALK"
]
},
{
"location" :
{
"latitude" : 37.3314215,
"longitude" : -122.030747
}
},
{
"location" :
{
"latitude" : 37.3317064,
"longitude" : -122.0307154
}
},
{
"location" :
{
"latitude" : 37.3319324,
"longitude" : -122.0307347
}
}
],
"place_id" : "ChIJAf9D3La1j4ARuwKZtGjgMXw",
"types" :
[
"premise",
"street_address"
]
}
],
"status" : "OK"
}
curl --location --request GET 'https://zylalabs.com/api/9139/reverse+geocode+location+data+retrieval+api/16531/geocoding?address=1 Infinite Loop, Cupertino, CA 95014, USA' --header 'Authorization: Bearer YOUR_API_KEY'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
O endpoint de Geocodificação Reversa retorna informações geográficas estruturadas com base em coordenadas de latitude e longitude Isso inclui um endereço formatado componentes do endereço (como número da rua bairro cidade estado e código postal) coordenadas precisas tipo de localização viewport para mapeamento e códigos Plus
Os campos principais na resposta incluem `formatted_address`, `address_components`, `geometry.location` (com latitude e longitude), `location_type`, `viewport` e `plus_code`. Cada campo fornece detalhes geográficos específicos para identificação precisa de localizações
Os dados da resposta estão organizados em uma estrutura JSON. Os principais componentes incluem uma string `formatted_address`, um array de `address_components` detalhando cada parte do endereço, um objeto `geometry` contendo coordenadas de localização e um `plus_code` para representação alternativa da localização
O endpoint de Geocodificação fornece informações com base em um endereço especificado, retornando dados estruturados semelhantes ao endpoint de Geocodificação Reversa. Isso inclui o endereço formatado, componentes do endereço, coordenadas e códigos Plus, permitindo que os usuários convertam endereços em dados geográficos
Os usuários podem personalizar suas solicitações especificando latitude e longitude para o endpoint de Geocodificação Reversa ou um endereço para o endpoint de Geocodificação Parâmetros adicionais podem incluir preferências de idioma ou formatos de dados específicos dependendo das capacidades da API
Os dados são obtidos de uma combinação de bancos de dados geográficos autorizados, serviços de mapeamento e informações contribuídas por usuários Essa abordagem multissource ajuda a garantir uma cobertura abrangente e precisão dos detalhes geográficos
Casos de uso típicos incluem aplicativos de geolocalização serviços de logística e entrega validação de endereços análise de território e sistemas de informações geográficas (SIG) A API é útil para qualquer aplicativo que exija dados de localização precisos e informações de endereço estruturadas
Se a API retornar resultados parciais ou vazios os usuários devem verificar as coordenadas de entrada quanto à precisão Além disso considere implementar mecanismos de fallback como consultar locais próximos ou usar fontes de dados alternativas para melhorar a completude dos resultados
Nível de serviço:
100%
Tempo de resposta:
630ms
Nível de serviço:
100%
Tempo de resposta:
381ms
Nível de serviço:
100%
Tempo de resposta:
620ms
Nível de serviço:
100%
Tempo de resposta:
124ms
Nível de serviço:
100%
Tempo de resposta:
454ms
Nível de serviço:
100%
Tempo de resposta:
670ms
Nível de serviço:
100%
Tempo de resposta:
929ms
Nível de serviço:
100%
Tempo de resposta:
257ms
Nível de serviço:
100%
Tempo de resposta:
13.596ms
Nível de serviço:
100%
Tempo de resposta:
1.466ms
Nível de serviço:
100%
Tempo de resposta:
627ms
Nível de serviço:
100%
Tempo de resposta:
2.714ms
Nível de serviço:
100%
Tempo de resposta:
395ms
Nível de serviço:
100%
Tempo de resposta:
2.562ms
Nível de serviço:
100%
Tempo de resposta:
353ms
Nível de serviço:
100%
Tempo de resposta:
454ms
Nível de serviço:
100%
Tempo de resposta:
270ms
Nível de serviço:
100%
Tempo de resposta:
299ms
Nível de serviço:
100%
Tempo de resposta:
434ms
Nível de serviço:
100%
Tempo de resposta:
76ms
