A API Fetch Geocode Information permite obter informações geográficas precisas e estruturadas a partir de coordenadas de latitude e longitude. Ao receber 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 formato legível por humanos. Também são fornecidos address_components, 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, junto 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, junto 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. Plus codes (plus_code) com variantes compound_code e global_code também são incluídos, que são úteis para representar locais sem um endereço formal
Essa 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ções geográficas (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 suma, a API entrega 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/9138/fetch+geocode+information+api/16529/reverse+geocoding?latlng=40.714222,-73.961442' --header 'Authorization: Bearer YOUR_API_KEY'
Para usar este ponto de extremidade, 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/9138/fetch+geocode+information+api/16532/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 ponto de extremidade 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-chave 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 de `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 de 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 ponto de extremidade de Geocodificação Reversa ou um endereço para o ponto de extremidade 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 pelos 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 territorial e sistemas de informação geográfica (SIG) A API é útil para qualquer aplicação que exige 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 aprimorar a completude dos resultados
Nível de serviço:
100%
Tempo de resposta:
1.466ms
Nível de serviço:
100%
Tempo de resposta:
670ms
Nível de serviço:
100%
Tempo de resposta:
140ms
Nível de serviço:
50%
Tempo de resposta:
181ms
Nível de serviço:
100%
Tempo de resposta:
468ms
Nível de serviço:
100%
Tempo de resposta:
39ms
Nível de serviço:
83%
Tempo de resposta:
564ms
Nível de serviço:
100%
Tempo de resposta:
3.560ms
Nível de serviço:
100%
Tempo de resposta:
630ms
Nível de serviço:
100%
Tempo de resposta:
5.227ms
Nível de serviço:
100%
Tempo de resposta:
4.545ms
Nível de serviço:
100%
Tempo de resposta:
88ms
Nível de serviço:
100%
Tempo de resposta:
2.325ms
Nível de serviço:
100%
Tempo de resposta:
53ms
Nível de serviço:
100%
Tempo de resposta:
4.466ms
Nível de serviço:
100%
Tempo de resposta:
1.975ms
Nível de serviço:
100%
Tempo de resposta:
2.537ms
Nível de serviço:
100%
Tempo de resposta:
20ms
Nível de serviço:
100%
Tempo de resposta:
1.882ms
Nível de serviço:
100%
Tempo de resposta:
18ms
