Przeglądaj dokumentację
Dokumentacja API
Google Places API
Szukaj lokalnych firm i miejsc. Pobieranie nazw, adresów, współrzędnych, ocen i danych kontaktowych, gdy są dostępne.
Utwórz żądanie
Parametry zaawansowane
Zaczyna się na 1. Każda strona jest odrębnym wnioskiem.
Google tbs wyrażenie. Obsługiwane filtry różnią się według rodzaju wyszukiwania.
https://data.flashdata.dev/v1/queries/realtimeParametry
Wyślij source oraz query na najwyższym poziomie. Opcje źródłowe należą do params. Można pominąć pola opcjonalne.
Treść żądania
sourcestring / Wymagane- Ustaw na google_places.
querystring / Wymagane- Wyszukaj pytanie. Obsługuje operatorów wyszukiwania Google, takich jak strona: i intitle:.1 do 2000 znakiDomyślnie:
Nieustawione paramsobject / Opcjonalne- Settings dla tego wniosku.Domyślnie:
{} callback_urlstring · nullable / Opcjonalne- Async i tylko partia. Publiczne ukończenie HTTPS URL na porcie 443, do znaków 2,048. Brak danych uwierzytelniających użytkownika lub fragmentu URL. Omit, użyj null lub pustego łańcucha bez powiadomienia. W partii, ustawić to na każdym zapytaniu, na zewnątrz params.Domyślnie:
Nieustawione
Kraj, język i lokalizacja
params.glstring / Opcjonalne- Dwuliterowy kod kraju, taki jak my, gb, de lub sg. Ustaw wyraźnie, aby wybrać kraj.Dokładnie 2 znakiDomyślnie:
NieustawioneFormat zaakceptowany
^[A-Za-z]{2}$ params.hlstring / Opcjonalne- Język interfejsu Google. Ustaw wyraźnie aby wybrać język.1 do 35 znakiDomyślnie:
NieustawioneFormat zaakceptowany
^[A-Za-z0-9-]+$ params.locationstring / Opcjonalne- Wymagane miejsce wyszukiwania, najlepiej miasto, takie jak "London, England, United Kingdom". Dostępność zależy od rodzaju wyszukiwania.1 do 200 znakiDomyślnie:
Nieustawione
Paginacja
params.numinteger / Opcjonalne- Wymagana liczba wyników. FlashData nie dodaje stałej wartości domyślnej przy pominięciu. Zwrócona liczba może się różnić według typu zapytania i wyszukiwania.1 do 100, liczby całkowiteDomyślnie:
Nieustawione params.pageinteger / Opcjonalne- Żądana strona wyników. Ustaw wyraźnie. Każda strona jest oddzielnym API żądanie.1 do 100, liczby całkowiteDomyślnie:
Nieustawione
Filtry wyszukiwania
params.tbsstring / Opcjonalne- Wymagane filtry wyszukiwania Google, takie jak qdr: d za poprzedni dzień lub qdr: w za ostatni tydzień. Dostępność zależy od rodzaju wyszukiwania.1 do 200 znakiDomyślnie:
Nieustawione params.autocorrectboolean / Opcjonalne- Poproś o korektę pisowni za pomocą true lub o wyłączenie jej za pomocą false. Stosowane zachowanie zależy od rodzaju wyszukiwania; pominięcie użycia zachowania Google.
truelubfalseDomyślnie:Nieustawione
Odpowiedź
Realtime zwraca status: done z wyszukiwaniem w results[0]. Zapałki są w results[0].places. usage.credits Zapisuje zarzuty.
Wyniki opisują miejsca, w tym adresy i współrzędne, gdy są dostępne. Opinie i dane kontaktowe są opcjonalne; w przypadku geografii należy używać wyraźnych ustawień kraju i lokalizacji.
Przeczytaj wynik
Zapisz udane odpowiedzi JSON jako response.json. Zapisz to jako read-response.py i uruchom python read-response.py. Wykorzystuje tylko standardową bibliotekę Python i nie składa nowego wniosku.
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))Dostępne pola zależą od typu zapytania i wyszukiwania. Pola fakultatywne mogą być niedostępne, a dodatkowe pola mogą być zwracane.
Liczba zwróconych elementów i searchParameters.num mogą różnić się od params.num. Użyj zwróconej tablicy do określenia rzeczywistej liczby wyników.
Wszystkie pola odpowiedzi
| Pole | Opis |
|---|---|
sourcestring | Żądane źródło API. |
statusstring | zrobić, gdy realtime wniosek się powiedzie. |
created_atstring | Czas tworzenia odpowiedzi w formacie ISO 8601. |
usage.creditsnumber | Zasługi naliczane za wniosek, w oparciu o twój plan. |
results[0].searchParametersobject | Ustawienia wyszukiwania zgłoszone przez Google, przy czym zapytanie jest rejestrowane jako q. Zwrócone ustawienia mogą różnić się od żądanych wartości. |
results[0].placesarray | Lokalne wyniki wyszukiwania. |
results[0].places[].titlestring | Miejsce lub nazwa handlowa. |
results[0].places[].addressstring · optional | Adres ulicy. |
results[0].places[].latitudenumber · optional | Szerokość geograficzna. |
results[0].places[].longitudenumber · optional | Długość geograficzna. |
results[0].places[].ratingnumber · optional | Średnia ocena. |
results[0].places[].ratingCountinteger · optional | Liczba ocen. |
results[0].places[].categorystring · optional | Kategoria działalności. |
results[0].places[].phoneNumberstring · optional | Numer telefonu. |
results[0].places[].websitestring · optional | Strona biznesowa. |
results[0].places[].cidstring · optional | Identyfikator miejsca Google |
results[0].places[].positioninteger | Wynik. |
results[0].places[].priceLevelstring · optional | Wyświetlany poziom cen, gdy jest dostępny. |
Powyższe pola opisują domyślną odpowiedź JSON. Formaty JSON, proste teksty i Markdown.
Async i cykl życia serii
Składanie zwraca pokwitowanie, nie wyniki. Async tworzy jedno zadanie; wsadowe zwraca osobne zadanie w queries[] dla każdego akceptowanego zapytania. Śledź i odzyskaj każdą pracę niezależnie.
Prześlij do data.flashdata.dev; odczyt statusu pracy i wyniki api.flashdata.dev z tym samym X-API-Key. API podstawowe przykłady używać Python i cURL.
1. Zapisz zadanie IDs
Podczas przełączania na Async należy zachować pola żądania tego źródła. Dla Batch, umieścić każde żądanie wewnątrz tablicy zapytań obiektu JSON. Zapisz każdą zwróconą pracę ID.
2. Sprawdź status
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: ankieta z opóźnieniem i szacunkiemRetry-Aftergdy jest obecny.completed: pobrać wyniki.failed: Kontrolajob.error.Przeczytaj job.status, a nie status potwierdzenia zgłoszenia.
Sprawdź status · Python i cURL
Status zatrudnienia API3. Wyniki pobierania
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsPo zakończeniu, uwierzytelnić wynik odczytywany, a następnie pobrać 302 pamięci URL bez klucza API. Zapisać JSON w ciągu 24 godzin po zakończeniu.
Wyniki pobierania · Python i cURL · Formaty odpowiedzi
Wynik pobrania API reference
Sondaże i pobieranie istniejących wyników nie zużywają kredytów zapytania. Czas ankiety nie anuluje zadania: zachować ID zamiast przedkładania duplikatu pracy billable. Kody błędów i powtarzanie zachowania.
Webhooki zakończenia
Subskrybuj na zapytanie
Ustaw callback_url na najwyższym poziomie żądania async, lub wewnątrz każdego zapytania w partii, na zewnątrz params. Nie jest wymagany oddzielny wniosek o rejestrację webhook- rejestracji. Żądania Realtime nie wysyłają zwrotów.
Użyj publicznego HTTPS URL na porcie 443. FlashData POST powiadomienie dla każdego zadania osiągającego completed lub failed; zdarzenie zawiera linki, a nie sam wynik.
Potwierdzenie i weryfikacja
Powrót 2xx po trwałym przyjęciu wydarzenia. Kopiowanie według delivery_id, również wysłane jako X-Delivery-Id. Przekierowanie nie jest przestrzegane.
Nieudane dostawy ponownie spróbować z wykładniczym backupu, aż do 8 próbuje w sumie i co najwyżej 24 godziny po zakończeniu. Kontynuuj sondaże jako zapas.
Przekazy są niepodpisane. Potwierdź zadanie ID, źródło i status terminala poprzez Uwierzytelniony punkt końcowy stanu przed rozpatrzeniem powiadomienia. Dostawa ID jest dla dedukcji, a nie dowód autentyczności.
Przykład zdarzenia i pól haka webowego
{
"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"
}
]
}| Pole | Opis |
|---|---|
delivery_idstring | Stabilny identyfikator dostawy. Notyfikacje kopiujące przy użyciu tej wartości; jest również wysyłane w nagłówku X-Delivery-Id. |
idstring | Job ID. |
sourcestring | Wymagane źródło danych. |
statusstring | ukończone lub nie. |
linksarray | Powiązania stanu i wyników. Powiadomienia nie zawierają treści wyników ani klucza API. |
links[].relstring | siebie lub wyników. |
links[].hrefstring | Absolute Management API URL; uwierzytelniaj kluczykiem API. |
links[].methodstring | GET. |
Błąd przy odzyskiwaniu
Ukończone wyszukiwanie może zawierać mniej dopasowań niż wnioskowano. Sprawdź gl, hl, lokalizacja i filtry; opcjonalne pola wyników mogą być nieobecne.
W przypadku błędów w uwierzytelnianiu, równowadze, formacie request- format i limicie rate- limit, użyj współdzielonego odniesienia błędu. Czas składania może jeszcze utworzyć pracę; sprawdzić istniejącą pracę przed ponownym uruchomieniem.
Błędy i kody statusu · Kiedy spróbować ponownie · Limity stóp procentowych
Przewodnik po krokach: Wybierz i udoskonal wyszukiwanie Google
Cennik
| Plany | Wskaźniki stosowaniaza 1 000 żądań | Subskrypcje | Zawarte kredyty na okres rozliczeniowy |
|---|---|---|---|
| Płatność za użycie | 1,00 USD | Bez opłaty miesięcznej | Doładuj w razie potrzeby |
| Micro | 0,80 USD | 49,00 USD / miesiąc | Kredyty 1000 (50,00 USD wykorzystania API) włączone do |
| Starter | 0,65 USD | 199,00 USD / miesiąc | Kredyty 4000 (200,00 USD wykorzystania API) włączone do |
| Pro | 0,60 USD | 499,00 USD / miesiąc | Kredyty 10 000 (500,00 USD wykorzystania API) włączone do |
| Scale | 0,50 USD | 999,00 USD / miesiąc | Kredyty 20 000 (1000,00 USD wykorzystania API) włączone do |
| Business | 0,40 USD | 1999,00 USD / miesiąc | Kredyty 40 000 (2000,00 USD wykorzystania API) włączone do |
Jeden plan konta. Wspólne kredyty dla trzech produktów. Użycie pokryte kredytami w planie nie jest naliczane ponownie.
Ceny bieżące i limity dotyczące planów