Explorar documentação
Referência da API
Google Places API
Procure por negócios e lugares locais. Recupere nomes, endereços, coordenadas, classificações e dados de contato quando disponíveis.
Monte uma requisição
Parâmetros avançados
Começa em 1. Cada página é uma requisição separada.
Google expressão tbs. Filtros suportados variam de acordo com o tipo de busca.
https://data.flashdata.dev/v1/queries/realtimeParâmetros
Enviar source e.. query no nível superior. As opções de origem pertencem a params. Campos opcionais podem ser omitidos.
Corpo da requisição
sourcestring / Obrigatório- Preparar para google_places.
querystring / Obrigatório- Pesquisando. Suporta operadores de busca Google como site e título:1 para 2.000 personagensPredefinição:
Não está pronto paramsobject / Opcional- Settings para este pedido.Predefinição:
{} callback_urlstring · nullable / Opcional- Async e apenas lote. HTTPS conclusão URL na porta 443, até caracteres 2,048. Sem credenciais de usuário ou fragmento URL. Omit, use null ou uma string vazia para nenhuma notificação. Em um lote, coloque isso em cada consulta, fora dos parâmetros.Predefinição:
Não está pronto
País, idioma e localização
params.glstring / Opcional- Código de país de duas letras, como nós, gb, de ou sg. Defina explicitamente para selecionar um país.Exatamente 2 personagensPredefinição:
Não está prontoFormato aceito
^[A-Za-z]{2}$ params.hlstring / Opcional- Google linguagem de interface. Defina explicitamente para selecionar um idioma.1 para 35 personagensPredefinição:
Não está prontoFormato aceito
^[A-Za-z0-9-]+$ params.locationstring / Opcional- Local de busca solicitado, de preferência uma cidade, como "London, England, United Kingdom". Disponibilidade depende do tipo de busca.1 para 200 personagensPredefinição:
Não está pronto
Paginação
params.numinteger / Opcional- Número de resultados solicitados. FlashData não adiciona um padrão fixo quando omitido. A contagem retornada pode diferir por tipo de pesquisa e pesquisa.1 para 100, números inteirosPredefinição:
Não está pronto params.pageinteger / Opcional- Página de resultados solicitada. Set explicitamente. Cada página é um pedido API separado.1 para 100, números inteirosPredefinição:
Não está pronto
Filtros de busca
params.tbsstring / Opcional- Solicitados filtros de busca Google, como qdr:d para o último dia ou qdr:w para a última semana. Disponibilidade depende do tipo de busca.1 para 200 personagensPredefinição:
Não está pronto params.autocorrectboolean / Opcional- Solicite correção ortográfica com true ou peça desativada com false. O comportamento aplicado depende do tipo de busca, omitir usar o comportamento do Google.
trueoufalsePredefinição:Não está pronto
Resposta
Realtime retorna status: done com a saída de busca em results[0]. Os fósforos estão dentro results[0].places. usage.credits Registra a acusação.
Os resultados descrevem lugares, incluindo endereços e coordenadas quando disponíveis. Avaliações e detalhes de contato são opcionais. Use o país explícito e configurações de localização quando a geografia importa.
Leia o resultado
Salve a resposta JSON bem sucedida como response.json. Guarde isso como read-response.py e execute python read-response.py. Ele usa apenas a biblioteca padrão do Python e não faz nenhum novo pedido.
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = [
{name: item.get(name) for name in ("title", "address", "latitude", "longitude", "website")}
for item in result.get("places", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))Campos disponíveis dependem do tipo de pesquisa e pesquisa. Campos opcionais podem estar ausentes, e campos adicionais podem ser devolvidos.
O número de itens devolvidos e searchParameters.num pode diferir do params.num. Use a matriz de retorno para determinar a contagem real de resultados.
Todos os campos de resposta
| Campo | Descrição |
|---|---|
sourcestring | A fonte API solicitada. |
statusstring | Feito quando o pedido em tempo real for bem sucedido. |
created_atstring | Tempo de criação de resposta no formato ISO 8601. |
usage.creditsnumber | Créditos cobrados pelo pedido, baseado no seu plano. |
results[0].searchParametersobject | Configurações de pesquisa relatadas por Google, com a consulta gravada como q. Configurações devolvidas podem diferir dos valores solicitados. |
results[0].placesarray | Resultados de busca local. |
results[0].places[].titlestring | Lugar ou nome comercial. |
results[0].places[].addressstring · optional | Endereço da rua. |
results[0].places[].latitudenumber · optional | Latitude. |
results[0].places[].longitudenumber · optional | Longitude. |
results[0].places[].ratingnumber · optional | Classificação média. |
results[0].places[].ratingCountinteger · optional | Número de audiências. |
results[0].places[].categorystring · optional | Categoria de negócios. |
results[0].places[].phoneNumberstring · optional | Número de telefone listado. |
results[0].places[].websitestring · optional | Site de negócios. |
results[0].places[].cidstring · optional | Google identificador de lugar. |
results[0].places[].positioninteger | Posição do resultado. |
results[0].places[].priceLevelstring · optional | Indicado nível de preço quando disponível. |
Os campos acima descrevem a resposta padrão JSON. JSON, texto simples e formatos Markdown.
Async & ciclo de vida em lote
A submissão devolve um recibo, não resultados. Async cria um trabalho; lote retorna um trabalho separado em queries[] para cada consulta aceita. Rastreie e recupere cada trabalho independentemente.
Submeta-se a data.flashdata.dev; ler status de trabalho e resultados de api.flashdata.dev com o mesmo X-API-Key. Os exemplos básicos do API ligados usam Python e cURL.
1. Salve o trabalho IDs
Mantenha os campos de solicitação desta fonte ao mudar para Async. Para Batch, coloque cada pedido dentro da matriz de consultas de um objeto JSON. Salve todos os trabalhos devolvidos ID.
2. Verifique o status
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: pesquisa com um atraso e respeitoRetry-Afterquando presente.completed: obter resultados.failed: Inspecionejob.error.Leia job.status, não o status do recibo de submissão.
Verifique o status de Python e cURL
Situação do trabalho referência API3. Recupere os resultados
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsApós a conclusão, autentique o resultado lido, e depois vá buscar o 302 de armazenamento URL sem sua chave API. Salve o JSON dentro de 24 horas de conclusão.
Obter resultados · Python e cURL · Formatos de resposta
Resultado do download da referência API
Pesquisando e buscando resultados existentes não consomem créditos de consulta. Um tempo de votação não cancela o trabalho: mantenha seu ID em vez de enviar duplicado trabalho billable. Códigos de erro e comportamento de repetição.
Webhooks de conclusão
Inscreva-se por consulta
Preparar callback_url no nível superior de um pedido de assincronização, ou dentro de cada consulta em um lote, fora params. Não é necessário nenhum pedido de registro separado. Pedidos Realtime não enviam chamadas de volta.
Use um HTTPS URL público no porto 443. FlashData POSTS uma notificação para cada trabalho chegando completed ou failed; O evento contém links, não o resultado em si.
Reconheça e verifique
Retorne 2xx depois de aceitar o evento. Deduplicar por delivery_id, também enviado como X-Delivery-Id. Redirecionamentos não são seguidos.
Entregas falhadas tentam novamente com retrocesso exponencial, até 8 tenta total e no máximo 24 horas após a conclusão. Continue pesquisando como um retrocesso.
As chamadas não foram assinadas. Confirme o trabalho ID, fonte e status terminal através do Endpoint de status autenticado Antes de processar a notificação. A entrega ID é para deduplicação, não prova de autenticidade.
Exemplo de eventos webhook e campos
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "google_places",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Campo | Descrição |
|---|---|
delivery_idstring | Identificador de entrega estável. Deduplicar notificações usando este valor; também é enviado no cabeçalho X-Delivery-Id. |
idstring | Trabalho ID. |
sourcestring | Solicitamos fonte de dados. |
statusstring | completo ou fracassado. |
linksarray | Status e links de resultados. Notificações não incluem conteúdo de resultado ou uma chave API. |
links[].relstring | auto ou resultados. |
links[].hrefstring | Gestão absoluta API URL, autentice com sua chave API. |
links[].methodstring | GET. |
Recuperação de erros
Uma busca completa pode conter menos correspondências do que solicitado. verificação. gl, hl, localização e filtros, campos opcionais de resultados ricos podem estar ausentes.
Para autenticação, equilíbrio, formatação de pedidos e falhas de taxa, use a referência de erro compartilhado. Um intervalo de submissão ainda pode ter criado um trabalho, verificar o trabalho existente antes de tentar novamente.
Erros e códigos de status · Quando tentar novamente · Limites de taxa
Guia passo-a-passo: Escolha e refine uma busca Google
Preços
| Planos | Taxas de usopor 1.000 solicitações | Assinaturas | Incluindo créditos por período de faturamento |
|---|---|---|---|
| Pague pelo uso | US$ 1,00 | Sem mensalidade | Recarregue quando precisar |
| Micro | US$ 0,80 | US$ 49,00 / Mês | 1.000 créditos (US$ 50,00 de API uso) incluído |
| Starter | US$ 0,65 | US$ 199,00 / Mês | 4.000 créditos (US$ 200,00 de API uso) incluído |
| Pro | US$ 0,60 | US$ 499,00 / Mês | 10.000 créditos (US$ 500,00 de API uso) incluído |
| Scale | US$ 0,50 | US$ 999,00 / Mês | 20.000 créditos (US$ 1.000,00 de API uso) incluído |
| Business | US$ 0,40 | US$ 1.999,00 / Mês | 40.000 créditos (US$ 2.000,00 de API uso) incluído |
Um plano por conta. Créditos compartilhados entre os três produtos. O uso coberto pelos créditos incluídos não é cobrado novamente.
Preços atuais e limites do plano