Você precisa de uma maneira rápida de listar campos de golfe para um estado ou província específica dos EUA, mostrar o nome, endereço e coordenadas de cada campo, e integrar isso ao seu aplicativo esta semana. Ao final deste guia, você fará uma consulta a um endpoint real de API esportiva para "campos de golfe por estado ou província", analisará os resultados e enviará com autenticação e paginação prontas para produção.
O que você pode construir com a API de Dados de Campos de Golfe
A API de Dados de Campos de Golfe fornece registros estruturados de campos de golfe para aplicações esportivas. Você pode recuperar campos de golfe filtrados por estado ou província e obter campos comumente necessários para listagens e pesquisas:
- Nome do campo e dados de endereço (endereço, cidade, estado, país)
- Campos de contato como telefone (quando disponível)
- Latitude e longitude para sobreposições de mapa e cálculos de distância
Endpoints adicionais suportam consultas por nome do campo e proximidade (coordenadas + raio), incluindo informações de cartões de pontuação e caixas de tee onde presentes. Esta API se encaixa em localizadores de horários de tee, diretórios de campos em aplicativos esportivos, ferramentas de planejamento de eventos e aplicativos de acompanhamento em campo.
Explore a API no Zyla API Hub: uma conta, uma chave de API, um modelo de assinatura + cota, e mais de 10.000 APIs públicas que você pode integrar. A API de Dados de Campos de Golfe está na categoria Esportes & Jogos e oferece um teste de 7 dias na página do item.
Começando no Zyla API Hub
Para chamar os endpoints:
- Abra a página da API de Dados de Campos de Golfe no Zyla API Hub e se inscreva.
- Obtenha sua chave de API na sua conta.
- Envie solicitações com o cabeçalho: Authorization: Bearer YOUR_API_KEY
Use a página de listagem para iniciar seu teste: Inicie o teste de 7 dias na API de Dados de Campos de Golfe. Verifique a página da API para opções de acesso e preços atuais. A cobrança é por assinatura + cota (não por chamada). Sem plano gratuito.
Endpoints que você usará
1) Campos de golfe por estado ou província
Recupere campos de golfe filtrados por estado e acesse o nome do campo, endereço, cidade, país e coordenadas geográficas.
- Método: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province
- Parâmetros de consulta obrigatórios:
- filter[state] (string): e.g., florida
- per_page (número): e.g., 1
- page (número): e.g., 1
Exemplo de URL de solicitação (sem corpo; passe seu token bearer no cabeçalho):
https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province?filter%5Bstate%5D=florida&per_page=1&page=1
A resposta retorna um array "courses" com objetos de campo. Os campos que você normalmente usará são courseName, address1, city, state, country, telephone (quando presente), latitude, longitude e ocasionalmente dados de classificação/cartão de pontuação onde disponíveis.
2) Campos de golfe por nome
Recupere informações detalhadas do campo de golfe pelo nome. Útil para barras de pesquisa diretas e deduplicação de registros de campos.
- Método: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name
- Parâmetros de consulta obrigatórios:
- filter[courseName] (string): e.g., Granadilla
Exemplo oficial de cURL (pronto para copiar e colar):
curl -s -X GET "https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name?filter%5BcourseName%5D=Granadilla" \
-H "Authorization: Bearer YOUR_API_KEY"
Exemplo oficial de JSON (campos que você normalmente lerá: courseName, address1, city, state, country, telephone, latitude, longitude, holes, scorecard, teeBoxes):
{"courses":[{"courseName":"Franklin Bridge Golf Club","address1":"750 Riverview Dr.","city":"Franklin","state":"Tennessee","country":"USA","telephone":"6157949400","ratings":"[]","latitude":"35.8930130","longitude":"-86.8406430"},{"courseName":"Franklin Bridge Golf Course","address1":"","city":"Franklin","state":"Tennessee","country":"USA","telephone":"","latitude":"35.8912540","longitude":"-86.8393630","website":"","holes":18,"lengthFormat":"Y","scorecard":"[{\"1\": \"4\", \"2\": \"5\", \"3\": \"3\", \"4\": \"4\", \"5\": \"3\", \"6\": \"4\", \"7\": \"4\", \"8\": \"4\", \"9\": \"5\", \"Out\": \"36\", \"Hole:\": \"Par:\"}, {\"1\": \"350\", \"2\": \"469\", \"3\": \"166\", \"4\": \"356\", \"5\": \"169\", \"6\": \"363\", \"7\": \"416\", \"8\": \"356\", \"9\": \"503\", \"Out\": \"3148\", \"Hole:\": \"Gold:\"}, {\"1\": \"0\", \"2\": \"0\", \"3\": \"0\", \"4\": \"0\", \"5\": \"0\", \"6\": \"0\", \"7\": \"0\", \"8\": \"0\", \"9\": \"0\", \"Out\": \"0\", \"Hole:\": \"Gold (May 2023):\"}, {\"1\": \"17\", \"2\": \"9\", \"3\": \"13\", \"4\": \"5\", \"5\": \"15\", \"6\": \"11\", \"7\": \"1\", \"8\": \"7\", \"9\": \"3\", \"Out\": \"\", \"Hole:\": \"Handicap:\"}, {\"10\": \"5\", \"11\": \"4\", \"12\": \"3\", \"13\": \"4\", \"14\": \"3\", \"15\": \"4\", \"16\": \"4\", \"17\": \"5\", \"18\": \"4\", \"In\": \"36\", \"Hole:\": \"Par:\", \"Total\": \"72\"}, {\"10\": \"503\", \"11\": \"347\", \"12\": \"162\", \"13\": \"380\", \"14\": \"164\", \"15\": \"354\", \"16\": \"371\", \"17\": \"539\", \"18\": \"327\", \"In\": \"3147\", \"Hole:\": \"Gold:\", \"Total\": \"6295\"}, {\"10\": \"0\", \"11\": \"0\", \"12\": \"0\", \"13\": \"0\", \"14\": \"0\", \"15\": \"0\", \"16\": \"0\", \"17\": \"0\", \"18\": \"0\", \"In\": \"0\", \"Hole:\": \"Gold (May 2023):\", \"Total\": \"6067\"}, {\"10\": \"8\", \"11\": \"18\", \"12\": \"14\", \"13\": \"2\", \"14\": \"16\", \"15\": \"10\", \"16\": \"12\", \"17\": \"6\", \"18\": \"4\", \"In\": \"\", \"Hole:\": \"Handicap:\", \"Total\": \"\"}]","teeBoxes":"[{\"name\": \"Gold\", \"slope\": \"121\", \"rating\": \"70.5\"}, {\"name\": \"Gold (May 2023)\", \"slope\": \"120\", \"rating\": \"69.2\"}]"},{"courseName":"Franklin Canyon GC","address1":"Highway 4","city":"Hercules","state":"California","country":"USA","ratings":"[]","latitude":"38.0054700","longitude":"-122.2160290"},{"courseName":"Franklin Canyon Golf Course","address1":"CA-4","city":"Hercules","state":"California","country":"USA","telephone":"(510) 799-6191","latitude":"38.0148580","longitude":"-…
O que ler na prática: - courses: um array de objetos de campo que você pode listar na sua interface - courseName/address1/city/state/country/telephone: campos de cartão de visita - latitude/longitude: pino do mapa e ordenação por distância - holes/lengthFormat/scorecard/teeBoxes: quando presentes, enriqueça páginas de detalhes com par, jardas, inclinações e classificações
3) Campos de golfe por coordenadas
Recupere campos dentro de um raio de um ponto. Ótimo para pesquisas "perto de mim" e de mapa.
- Método: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3595/golf-courses-by-coordinates
- Parâmetros de consulta obrigatórios:
- radius (string): não deve ser maior que 50
- latitude (string)
- longitude (string)
- page (string)
Use isso para complementar o filtro de estado com pesquisa de proximidade e para classificar os resultados do estado por distância se você tiver as coordenadas de um usuário.
Exemplo em Python: Buscar campos de golfe por estado ou província
O trecho abaixo chama o endpoint de estado/província, pagina uma página e imprime uma listagem compacta. Substitua YOUR_API_KEY pela sua chave.
import os
import requests
API_KEY = os.getenv("Zyla_API_Key", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province"
params = {
"filter[state]": "florida",
"per_page": 1,
"page": 1
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(BASE_URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
for c in data.get("courses", []):
name = c.get("courseName", "")
addr = c.get("address1", "")
city = c.get("city", "")
state = c.get("state", "")
country = c.get("country", "")
lat = c.get("latitude", "")
lon = c.get("longitude", "")
tel = c.get("telephone", "")
print(f"{name} | {addr}, {city}, {state}, {country} | tel={tel} | ({lat}, {lon})")
Notas: - Paginação: use per_page e page para iterar através de grandes estados. Armazene páginas localmente para evitar novas buscas quando os usuários rolarem. - Coordenadas são strings; converta para float ao executar cálculos de distância. - Alguns campos opcionais (telefone, site, classificações) podem estar ausentes ou ser strings vazias—verifique defensivamente antes de exibir.
cURL oficial que você pode usar agora mesmo
Abaixo está o cURL oficial pronto para execução para o endpoint de pesquisa por nome. Mantenha o cabeçalho de Autorização e os parâmetros exatamente como mostrado, substituindo sua chave.
Juntando tudo: casos de uso comuns em Esportes
- Diretório de estado/província: Crie uma página "Navegar por Estado". Use filter[state] com per_page/page para paginação. Vincule cada campo a uma página de detalhes que você pode enriquecer com os endpoints de nome ou coordenadas.
- Pesquisa com mapa em primeiro lugar: Combine o filtro de estado com o endpoint de coordenadas. Se um usuário selecionar "Flórida", carregue a primeira página do estado e, se ele habilitar a localização, chame o endpoint de coordenadas para destacar os clubes mais próximos dentro de um raio de 50 milhas (ou qualquer raio ≤ 50 conforme a nota da API).
- Planejamento de eventos: Para administradores de eventos esportivos que configuram torneios, pesquise por estado para selecionar locais. Em seguida, busque pelo nome para exibir buracos, par e caixas de tee quando disponíveis.
- Recurso móvel "perto de mim": Armazene a última consulta de coordenadas e atualize apenas quando o usuário se mover significativamente ou alterar o raio. Mantenha per_page pequeno para uma interface responsiva, depois carregue páginas adicionais de forma preguiçosa.
Chamando a API de agentes de IA via MCP
Você pode acionar os mesmos endpoints de agentes de codificação de IA compatíveis com o Protocolo de Contexto de Modelo (MCP). Aponte seu cliente para o gateway MCP:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Agentes como Claude Code, Cursor e Windsurf podem chamar a API de Dados de Campos de Golfe através deste endpoint MCP e usar o mesmo token bearer que você usa em cURL e Python. Para mais detalhes: MCP.
Detalhes operacionais que economizam tempo
- Autenticação: Use Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Paginação: Endpoints de estado e coordenadas aceitam page e/ou per_page. Comece com per_page ajustado para sua interface (por exemplo, 20) e incremente page à medida que os usuários rolam.
- Restrições de raio: Para o endpoint de coordenadas, o raio não deve ser maior que 50.
- Variabilidade de dados: Alguns campos opcionais como telefone, site, classificações e cartão de pontuação podem estar vazios ou omitidos. Escreva uma análise segura para nulos e oculte campos vazios.
- Cache: Armazene respostas por página por um curto período em seu armazenamento de borda ou cliente para manter a interface rápida e reduzir chamadas redundantes.
- Quotas: O marketplace usa um modelo de assinatura + cota. A primeira API à qual você se inscreve geralmente oferece um teste de 7 dias ou 50 solicitações—verifique a página do item para detalhes atuais.
Referência: resumo dos endpoints
- Campos de golfe por estado ou província (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province
- filter[state] (string, obrigatório), per_page (número, obrigatório), page (número, obrigatório)
- Campos de golfe por nome (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name
- filter[courseName] (string, obrigatório)
- Campos de golfe por coordenadas (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3595/golf-courses-by-coordinates
- radius (string, obrigatório; não deve ser maior que 50), latitude (string, obrigatório), longitude (string, obrigatório), page (string, obrigatório)
FAQ
Como eu autentico?
Envie Authorization: Bearer YOUR_API_KEY nos cabeçalhos da solicitação para cada endpoint.
Como eu faço a paginação dos resultados do estado?
Use per_page para controlar o tamanho da página e page para iterar. Busque páginas subsequentes à medida que os usuários rolam ou paginam em sua interface.
Quais campos devo esperar para um campo?
Os campos comuns incluem courseName, address1, city, state, country, telephone (quando presente), latitude, longitude. Alguns endpoints também retornam holes, scorecard e teeBoxes.
Há um limite para pesquisas de proximidade?
Sim. Para o endpoint de coordenadas, o raio não deve ser maior que 50.
Quais são as opções de preços e teste?
O marketplace usa um modelo de assinatura + cota. A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Pronto para enviar seu diretório de campos de golfe por estado ou província? Inscreva-se e obtenha sua chave na página do item: Inicie o teste de 7 dias na API de Dados de Campos de Golfe.
Resposta oficial da API
{"courses":[{"courseName":"Franklin Bridge Golf Club","address1":"750 Riverview Dr.","city":"Franklin","state":"Tennessee","country":"USA","telephone":"6157949400","ratings":"[]","latitude":"35.8930130","longitude":"-86.8406430"},{"courseName":"Franklin Bridge Golf Course","address1":"","city":"Franklin","state":"Tennessee","country":"USA","telephone":"","latitude":"35.8912540","longitude":"-86.8393630","website":"","holes":18,"lengthFormat":"Y","scorecard":"[{22: 242, 222: 252, 232: 232, 242: 242, 252: 232, 262: 242, 272: 242, 282: 242, 292: 252, 2Out2: 2362, 2Hole:2: 2Par:2}, {212: 23502, 222: 24692, 232: 21662, 242: 23562, 252: 21692, 262: 23632, 272: 24162, 282: 23562, 292: 25032, 2Out2: 231482, 2Hole:2: 2Gold:2}, {212: 202, 222: 202, 232: 202, 242: 202, 252: 202, 262: 202, 272: 202, 282: 202, 292: 202, 2Out2: 202, 2Hole:2: 2Gold (Maio 2023):2}, {212: 2172, 222: 292, 232: 2132, 242: 252, 252: 2152, 262: 2112, 272: 212, 282: 272, 292: 232, 2Out2: 22, 2Hole:2: 2Handicap:2}, {2102: 252, 2112: 242, 2122: 232, 2132: 242, 2142: 232, 2152: 242, 2162: 242, 2172: 252, 2182: 242, 2In2: 2362, 2Hole:2: 2Par:2, 2Total2: 2722}, {2102: 25032, 2112: 23472, 2122: 21622, 2132: 23802, 2142: 21642, 2152: 23542, 2162: 23712, 2172: 25392, 2182: 23272, 2In2: 231472, 2Hole:2: 2Gold:2, 2Total2: 262952}, {2102: 202, 2112: 202, 2122: 202, 2132: 202, 2142: 202, 2152: 202, 2162: 202, 2172: 202, 2182: 202, 2In2: 202, 2Hole:2: 2Gold (Maio 2023):2, 2Total2: 260672}, {2102: 282, 2112: 2182, 2122: 2142, 2132: 222, 2142: 2162, 2152: 2102, 2162: 2122, 2172: 262, 2182: 242, 2In2: 22, 2Hole:2: 2Handicap:2, 2Total2: 22}]","teeBoxes":"[{2name2: 2Gold2, 2slope2: 21212, 2rating2: 270.52}, {2name2: 2Gold (Maio 2023)2, 2slope2: 21202, 2rating2: 269.22}]"},{"courseName":"Franklin Canyon GC","address1":"Highway 4","city":"Hercules","state":"California","country":"USA","ratings":"[]","latitude":"38.0054700","longitude":"-122.2160290"},{"courseName":"Franklin Canyon Golf Course","address1":"CA-4","city":"Hercules","state":"California","country":"USA","telephone":"(510) 799-6191","latitude":"38.0148580","longitude":"-…
Resposta oficial da API
{"courses":[{"courseName":"Franklin Bridge Golf Club","address1":"750 Riverview Dr.","city":"Franklin","state":"Tennessee","country":"USA","telephone":"6157949400","ratings":"[]","latitude":"35.8930130","longitude":"-86.8406430"},{"courseName":"Franklin Bridge Golf Course","address1":"","city":"Franklin","state":"Tennessee","country":"USA","telephone":"","latitude":"35.8912540","longitude":"-86.8393630","website":"","holes":18,"lengthFormat":"Y","scorecard":"[{22: 242, 222: 252, 232: 232, 242: 242, 252: 232, 262: 242, 272: 242, 282: 242, 292: 252, 2Out2: 2362, 2Hole:2: 2Par:2}, {212: 23502, 222: 24692, 232: 21662, 242: 23562, 252: 21692, 262: 23632, 272: 24162, 282: 23562, 292: 25032, 2Out2: 231482, 2Hole:2: 2Gold:2}, {212: 202, 222: 202, 232: 202, 242: 202, 252: 202, 262: 202, 272: 202, 282: 202, 292: 202, 2Out2: 202, 2Hole:2: 2Gold (Maio 2023):2}, {212: 2172, 222: 292, 232: 2132, 242: 252, 252: 2152, 262: 2112, 272: 212, 282: 272, 292: 232, 2Out2: 22, 2Hole:2: 2Handicap:2}, {2102: 252, 2112: 242, 2122: 232, 2132: 242, 2142: 232, 2152: 242, 2162: 242, 2172: 252, 2182: 242, 2In2: 2362, 2Hole:2: 2Par:2, 2Total2: 2722}, {2102: 25032, 2112: 23472, 2122: 21622, 2132: 23802, 2142: 21642, 2152: 23542, 2162: 23712, 2172: 25392, 2182: 23272, 2In2: 231472, 2Hole:2: 2Gold:2, 2Total2: 262952}, {2102: 202, 2112: 202, 2122: 202, 2132: 202, 2142: 202, 2152: 202, 2162: 202, 2172: 202, 2182: 202, 2In2: 202, 2Hole:2: 2Gold (Maio 2023):2, 2Total2: 260672}, {2102: 282, 2112: 2182, 2122: 2142, 2132: 222, 2142: 2162, 2152: 2102, 2162: 2122, 2172: 262, 2182: 242, 2In2: 22, 2Hole:2: 2Handicap:2, 2Total2: 22}]","teeBoxes":"[{2name2: 2Gold2, 2slope2: 21212, 2rating2: 270.52}, {2name2: 2Gold (Maio 2023)2, 2slope2: 21202, 2rating2: 269.22}]"},{"courseName":"Franklin Canyon GC","address1":"Highway 4","city":"Hercules","state":"California","country":"USA","ratings":"[]","latitude":"38.0054700","longitude":"-122.2160290"},{"courseName":"Franklin Canyon Golf Course","address1":"CA-4","city":"Hercules","state":"California","country":"USA","telephone":"(510) 799-6191","latitude":"38.0148580","longitude":"-…