# FlashData Google Places API

Szukaj lokalnych firm i miejsc. Pobieranie nazw, adresów, współrzędnych, ocen i danych kontaktowych, gdy są dostępne.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/sources/google_places
Przegląd: 2026-10-23

Punkt końcowy: POST https://data.flashdata.dev/v1/queries/realtime
Uwierzytelnianie: X-API-Key: YOUR_API_KEY
Tryby: [Realtime](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/pl/docs/reference/batch-and-bulk/reference.md#batch)

Wymagane zezwolenie na korzystanie ze źródła: google_places

Zastąp YOUR_API_KEY kluczem API, który posiada to pozwolenie źródłowe i dostępne kredyty. Uruchom żądania na serwerze lub hoście agenta.

[Konfiguracja uwierzytelniania](https://flashdata.dev/pl/docs/guides/headers-and-authentication/reference.md)

[Wybierz i udoskonal wyszukiwanie Google](https://flashdata.dev/pl/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## Wyślij wniosek

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_places",
    "query": "coffee in san francisco",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_places",
  "query": "coffee in san francisco",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Parametry

<a id="parameters-group-0"></a>

### Treść żądania

| Parametr | Rodzaj | Wymagane | Domyślnie | Opis |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Tak | — | Ustaw na google_places.  |
| <a id="parameter-query"></a> query | string | Tak | Nieustawione | Wyszukaj pytanie. Obsługuje operatorów wyszukiwania Google, takich jak strona: i intitle:. Minimalna długość: 1. Maksymalna długość: 2000. |
| <a id="parameter-params"></a> params | object | Nie | {} | Settings dla tego wniosku.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nie | Nieustawione | 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.  |

<a id="parameters-group-1"></a>

### Kraj, język i lokalizacja

| Parametr | Rodzaj | Wymagane | Domyślnie | Opis |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Nie | Nieustawione | Dwuliterowy kod kraju, taki jak my, gb, de lub sg. Ustaw wyraźnie, aby wybrać kraj. Minimalna długość: 2. Maksymalna długość: 2. Wzór: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Nie | Nieustawione | Język interfejsu Google. Ustaw wyraźnie aby wybrać język. Minimalna długość: 1. Maksymalna długość: 35. Wzór: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Nie | Nieustawione | Wymagane miejsce wyszukiwania, najlepiej miasto, takie jak "London, England, United Kingdom". Dostępność zależy od rodzaju wyszukiwania. Minimalna długość: 1. Maksymalna długość: 200. |

<a id="parameters-group-2"></a>

### Paginacja

| Parametr | Rodzaj | Wymagane | Domyślnie | Opis |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Nie | Nieustawione | 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. Minimalna: 1. Maksimum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Nie | Nieustawione | Żądana strona wyników. Ustaw wyraźnie. Każda strona jest oddzielnym API żądanie. Minimalna: 1. Maksimum: 100. |

<a id="parameters-group-3"></a>

### Filtry wyszukiwania

| Parametr | Rodzaj | Wymagane | Domyślnie | Opis |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Nie | Nieustawione | Wymagane filtry wyszukiwania Google, takie jak qdr: d za poprzedni dzień lub qdr: w za ostatni tydzień. Dostępność zależy od rodzaju wyszukiwania. Minimalna długość: 1. Maksymalna długość: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Nie | Nieustawione | 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.  |

<a id="response"></a>

## 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.

### read-response.py

```python
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))
```

## Przykładowa odpowiedź

Nagrywany przykład; pola i liczby zależą od źródła i żądanego wejścia.
```json
{
  "source": "google_places",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "coffee in san francisco",
        "gl": "us",
        "hl": "en",
        "type": "places",
        "num": 10,
        "page": 1,
        "engine": "google"
      },
      "places": [
        {
          "position": 1,
          "title": "Kopê House",
          "address": "546 Laguna St",
          "latitude": 37.776222,
          "longitude": -122.42606,
          "rating": 4.9,
          "ratingCount": 76,
          "priceLevel": "$1–10",
          "category": "Cafe",
          "cid": "7430826673754830499"
        },
        {
          "position": 2,
          "title": "The Coffee Berry SF",
          "address": "1410 Lombard St",
          "latitude": 37.80141,
          "longitude": -122.424995,
          "rating": 4.9,
          "ratingCount": 642,
          "priceLevel": "$1–10",
          "category": "Coffee shop",
          "cid": "5181132708478222499"
        },
        {
          "position": 3,
          "title": "Sightglass Coffee",
          "address": "270 7th St",
          "latitude": 37.77704,
          "longitude": -122.40844,
          "rating": 4.4,
          "ratingCount": 3400,
          "priceLevel": "$10–20",
          "category": "Coffee shop",
          "cid": "13926460886861596347"
        },
        {
          "position": 4,
          "title": "Origin Lab Coffee & Matcha",
          "address": "211 Sutter St",
          "latitude": 37.789722,
          "longitude": -122.404175,
          "rating": 4.7,
          "ratingCount": 624,
          "priceLevel": "$1–10",
          "category": "Coffee shop",
          "cid": "9114931074474087601"
        },
        {
          "position": 5,
          "title": "The Coffee Movement",
          "address": "1737 Balboa St",
          "latitude": 37.7765,
          "longitude": -122.477806,
          "rating": 4.8,
          "ratingCount": 623,
          "priceLevel": "$1–10",
          "category": "Coffee shop",
          "cid": "2726196137705445702"
        },
        {
          "position": 6,
          "title": "Third Wheel Coffee",
          "address": "991 Oak St",
          "latitude": 37.77323,
          "longitude": -122.43559,
          "rating": 4.9,
          "ratingCount": 266,
          "priceLevel": "$1–10",
          "category": "Coffee shop",
          "cid": "1837357391573517555"
        },
        {
          "position": 7,
          "title": "Better Half Coffee",
          "address": "1448 Pacific Ave",
          "latitude": 37.79555,
          "longitude": -122.41909,
          "rating": 4.9,
          "ratingCount": 123,
          "priceLevel": "$10–20",
          "category": "Coffee shop",
          "cid": "11196405476986641272"
        },
        {
          "position": 8,
          "title": "Sextant Coffee Roasters",
          "address": "1415 Folsom St",
          "latitude": 37.772472,
          "longitude": -122.412964,
          "rating": 4.4,
          "ratingCount": 746,
          "priceLevel": "$1–10",
          "category": "Coffee shop",
          "cid": "16500984014294458956"
        },
        {
          "position": 9,
          "title": "Doppio Coffee & Brunch",
          "address": "1551 Mission St",
          "latitude": 37.773315,
          "longitude": -122.418015,
          "rating": 4.8,
          "ratingCount": 494,
          "priceLevel": "$10–20",
          "category": "Coffee shop",
          "cid": "16475263059648961979"
        },
        {
          "position": 10,
          "title": "Delah Coffee",
          "address": "370 4th St",
          "latitude": 37.781017,
          "longitude": -122.40022,
          "rating": 4.6,
          "ratingCount": 1200,
          "priceLevel": "$10–20",
          "category": "Coffee shop",
          "cid": "10682847123881919373"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:45.679Z"
}
```

## Pola odpowiedzi

| Pole | Rodzaj | Opis |
| --- | --- | --- |
| source | string | Żądane źródło API. |
| status | string | zrobić, gdy realtime wniosek się powiedzie. |
| created_at | string | Czas tworzenia odpowiedzi w formacie ISO 8601. |
| usage.credits | number | Zasługi naliczane za wniosek, w oparciu o twój plan. |
| results[0].searchParameters | object | 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].places | array | Lokalne wyniki wyszukiwania. |
| results[0].places[].title | string | Miejsce lub nazwa handlowa. |
| results[0].places[].address | string · optional | Adres ulicy. |
| results[0].places[].latitude | number · optional | Szerokość geograficzna. |
| results[0].places[].longitude | number · optional | Długość geograficzna. |
| results[0].places[].rating | number · optional | Średnia ocena. |
| results[0].places[].ratingCount | integer · optional | Liczba ocen. |
| results[0].places[].category | string · optional | Kategoria działalności. |
| results[0].places[].phoneNumber | string · optional | Numer telefonu. |
| results[0].places[].website | string · optional | Strona biznesowa. |
| results[0].places[].cid | string · optional | Identyfikator miejsca Google |
| results[0].places[].position | integer | Wynik. |
| results[0].places[].priceLevel | string · optional | Wyświetlany poziom cen, gdy jest dostępny. |

- 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.

## Formaty odpowiedzi

Odpowiedzi używać JSON domyślnie. Wybierz inny format z tymi opcjonalnymi nagłówkami.

- Accept: application/json (domyślne) lub text/plain. Prosty tekst przedstawia te same pola w czytelnym, wciętym układzie.
- X-Respond-With: markdown. Pozostawić nieustawione dla oryginalnych pól. Markdown współpracuje z każdym z formatów odpowiedzi.

Markdown jest dostępny dla zapytań w czasie rzeczywistym i ukończonych wyników.

Poniższe pola opisują domyślną odpowiedź JSON.

[Przykłady formularzy zapytań i odpowiedzi](https://flashdata.dev/pl/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## Podstawy API

Konstruktor wniosków i przykłady powyżej korzystają z parametrów tego źródła. Użyj poniższych przykładów Python i cURL dla wspólnych etapów składania, statusu i rezultatu. Batch to obiekt JSON zawierający zapytania; każdy element zwraca swoje własne zadanie ID.

- [Async wniosek i odbiór](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Sprawdzić status pracy](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Pobieranie zakończonych wyników](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON wnioski](https://flashdata.dev/pl/docs/reference/batch-and-bulk/reference.md#batch)
- [Klient OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Powiadomienia o zakończeniu

- [Otrzymuj i weryfikuj ukończone haki](https://flashdata.dev/pl/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Rozwiązywanie problemów

- [Błędy i kody statusu](https://flashdata.dev/pl/docs/errors/reference.md#status-codes)
- [Kiedy spróbować ponownie](https://flashdata.dev/pl/docs/errors/reference.md#retries)

## Powiązane API

- [Google Search API](https://flashdata.dev/pl/docs/sources/google_search/reference.md)
- [Google Images API](https://flashdata.dev/pl/docs/sources/google_images/reference.md)
