{
"total": 2,
"items": [
{
"id": "08f1a2b3c4d5e6f7",
"name": "Cafe Central",
"category": "cafe",
"brand_name": null,
"address": "11000, RS, Belgrade, Stari Grad, Knez Mihailova",
"latitude": 44.8176,
"longitude": 20.4569,
"distance_m": 42.5
}
],
"next_cursor": "eyJkIjo0Mi41LCJpZCI6IjA4ZjFhMmIzYzRkNWU2ZjcifQ"
}
curl --location --request GET 'https://zylalabs.com/api/14930/apihub+places+api/39016/places' --header 'Authorization: Bearer YOUR_API_KEY'
{
"total": 1,
"items": [
{
"id": "08f1a2b3c4d5e6f7",
"name": "Cafe Central",
"category": "cafe",
"brand_name": null,
"address": "11000, RS, Belgrade, Stari Grad, Knez Mihailova",
"latitude": 44.8176,
"longitude": 20.4569,
"distance_m": 42.5
}
],
"next_cursor": null
}
curl --location --request GET 'https://zylalabs.com/api/14930/apihub+places+api/39017/all-places' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a apihub lugares API basta incluir seu token Bearer no cabeçalho Authorization.
| 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.
(Economize 2 meses com cobrança anual 🎉)
O endpoint `GET /api/places` retorna uma lista de lugares dentro de um raio especificado, incluindo detalhes como nome do lugar, categoria, endereço, latitude, longitude e distância do ponto de consulta O endpoint `GET /api/places-all` retorna todos os lugares correspondentes sem paginação, fornecendo a mesma estrutura de dados
Os campos principais na resposta incluem `id` (identificador único) `name` (nome do lugar) `category` (tipo de lugar) `brand_name` (se aplicável) `address` (detalhes da localização) `latitude` `longitude` e `distance_m` (distância do ponto de consulta)
Os dados de resposta estão estruturados no formato JSON Inclui uma contagem `total` de correspondências um array `items` contendo detalhes de locais e um `next_cursor` para paginação Cada item no array `items` possui campos como `id` `name` e `distance_m`
Os parâmetros para `GET /api/places` incluem `lat`, `lon` (para localização), `range_m` (raio de busca), `q` (correspondência de substring para nome de lugar ou marca), `category` (correspondência de substring para categoria), `limit` (número de resultados) e `cursor` (para paginação) O `GET /api/places-all` ignora `limit` e `cursor`
Ambos os endpoints fornecem informações sobre lugares, incluindo seus nomes, categorias, endereços, coordenadas geográficas e distâncias da localização especificada. O `GET /api/places` permite buscas filtradas, enquanto o `GET /api/places-all` retorna todas as correspondências
Os usuários podem utilizar os dados retornados para exibir lugares próximos com base na localização do usuário filtrar resultados por categoria ou nome e paginar pelos resultados usando o next_cursor Isso é útil para aplicativos como serviços baseados em localização ou guias de viagem
Casos de uso típicos incluem desenvolver aplicativos baseados em localização criar guias de viagens e turismo melhorar funcionalidades de busca local e integrar com serviços de mapeamento para fornecer aos usuários lugares de interesse nas proximidades
A precisão dos dados é mantida através de atualizações regulares e verificações de qualidade embora fontes e métodos específicos não sejam detalhados Os usuários podem esperar informações confiáveis com base nos dados do Overture Maps carregados no PostGIS