A API de Dados 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 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 territorial, 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 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/9129/reverse+geocode+data+api/16516/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/9129/reverse+geocode+data+api/16517/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 local 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 da localização
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 as 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 provenientes de uma combinação de bancos de dados geográficos autorizados, serviços de mapeamento e informações fornecidas por usuários. Essa abordagem de múltiplas fontes ajuda a garantir uma cobertura abrangente e a precisão dos detalhes geográficos
Os casos de uso típicos incluem aplicações 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 aplicação 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 para 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:
370ms
Nível de serviço:
100%
Tempo de resposta:
630ms
Nível de serviço:
100%
Tempo de resposta:
121ms
Nível de serviço:
100%
Tempo de resposta:
125ms
Nível de serviço:
100%
Tempo de resposta:
620ms
Nível de serviço:
100%
Tempo de resposta:
929ms
Nível de serviço:
100%
Tempo de resposta:
1.466ms
Nível de serviço:
100%
Tempo de resposta:
723ms
Nível de serviço:
100%
Tempo de resposta:
8.748ms
Nível de serviço:
100%
Tempo de resposta:
342ms
Nível de serviço:
100%
Tempo de resposta:
16.572ms
Nível de serviço:
100%
Tempo de resposta:
15ms
Nível de serviço:
100%
Tempo de resposta:
12.779ms
Nível de serviço:
100%
Tempo de resposta:
15ms
Nível de serviço:
100%
Tempo de resposta:
18ms
Nível de serviço:
100%
Tempo de resposta:
2.184ms
Nível de serviço:
100%
Tempo de resposta:
2.260ms
Nível de serviço:
100%
Tempo de resposta:
2.533ms
Nível de serviço:
100%
Tempo de resposta:
17ms
Nível de serviço:
100%
Tempo de resposta:
3.670ms
