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:
620ms
Nível de serviço:
100%
Tempo de resposta:
391ms
Nível de serviço:
100%
Tempo de resposta:
670ms
Nível de serviço:
100%
Tempo de resposta:
130ms
Nível de serviço:
100%
Tempo de resposta:
128ms
Nível de serviço:
100%
Tempo de resposta:
929ms
Nível de serviço:
100%
Tempo de resposta:
13.258ms
Nível de serviço:
100%
Tempo de resposta:
456ms
Nível de serviço:
100%
Tempo de resposta:
1.466ms
Nível de serviço:
100%
Tempo de resposta:
16ms
Nível de serviço:
100%
Tempo de resposta:
9.138ms
Nível de serviço:
100%
Tempo de resposta:
16ms
Nível de serviço:
100%
Tempo de resposta:
16ms
Nível de serviço:
100%
Tempo de resposta:
5.497ms
Nível de serviço:
100%
Tempo de resposta:
3.832ms
Nível de serviço:
100%
Tempo de resposta:
2.484ms
Nível de serviço:
100%
Tempo de resposta:
4.364ms
Nível de serviço:
100%
Tempo de resposta:
2.924ms
Nível de serviço:
100%
Tempo de resposta:
2.767ms
