# FlashData Google Places API

Zoek naar lokale bedrijven en plaatsen. Namen, adressen, coördinaten, ratings en contactgegevens ophalen indien beschikbaar.

Canonische referentie: https://flashdata.dev/nl/docs/sources/google_places
Beoordeeld: 2026-10-23

Eindpunt: POST https://data.flashdata.dev/v1/queries/realtime
Authenticatie: X-API-Key: YOUR_API_KEY
Modi: [Realtime](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/nl/docs/reference/batch-and-bulk/reference.md#batch)

Vereiste brontoestemming: google_places

Vervang YOUR_API_KEY door een API sleutel met deze bronmachtiging en beschikbare credits. Verzoeken uitvoeren op uw server of agent host.

[Authenticatie instellen](https://flashdata.dev/nl/docs/guides/headers-and-authentication/reference.md)

[Een Google-zoekopdracht kiezen en verfijnen](https://flashdata.dev/nl/docs/guides/google-search-guide/reference.md)

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

## Een verzoek versturen

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

## Parameters

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

### Aanvraaginhoud

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ja | — | Instellen op google_places.  |
| <a id="parameter-query"></a> query | string | Ja | Niet ingesteld | Zoekopdracht. Ondersteunt Google zoekoperators zoals site: en titel:. Min lengte: 1. Maximale lengte: 2000. |
| <a id="parameter-params"></a> params | object | Nee | {} | Settings voor dit verzoek.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nee | Niet ingesteld | Async en alleen batch. Publieke HTTPS voltooiing URL op poort 443, tot 2,048 tekens. Geen gebruikersgegevens of URL-fragment. Gebruik null of een lege tekenreeks zonder melding. In een batch, zet dit op elke query, buiten params.  |

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

### Land, taal en locatie

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Nee | Niet ingesteld | Tweeletterige landcode, zoals wij, GB, de of sg. Stel expliciet in om een land te selecteren. Min lengte: 2. Maximale lengte: 2. Patroon: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Nee | Niet ingesteld | Google interface taal. Stel expliciet in om een taal te selecteren. Min lengte: 1. Maximale lengte: 35. Patroon: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Nee | Niet ingesteld | Gevraagde zoeklocatie, bij voorkeur een stad, zoals "London, England, United Kingdom". Beschikbaarheid hangt af van het zoektype. Min lengte: 1. Maximale lengte: 200. |

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

### Paginatie

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Nee | Niet ingesteld | Ik heb gevraagd om het resultaat te tellen. FlashData voegt geen vaste standaard toe als deze wordt weggelaten. Het aantal teruggekeerden kan verschillen door zoekopdracht en zoektype. Minimum: 1. Maximum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Nee | Niet ingesteld | Opgevraagd resultaat pagina. Stel expliciet in. Elke pagina is een afzonderlijk API verzoek. Minimum: 1. Maximum: 100. |

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

### Zoekfilters

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Nee | Niet ingesteld | Google zoekfilters, zoals qdr:d voor de afgelopen dag of qdr:w voor de afgelopen week. Beschikbaarheid hangt af van het zoektype. Min lengte: 1. Maximale lengte: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Nee | Niet ingesteld | Vraag spellingcorrectie aan met true of vraag het uit te schakelen met false. Toegepast gedrag hangt af van het zoektype; laat het gedrag van Google achterwege.  |

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

## Lees het resultaat

Bewaar de succesvolle JSON respons als response.json. Sla dit op als read-response.py en voer python read-response.py uit. Het gebruikt alleen de standaardbibliotheek van Python en doet geen nieuw verzoek.

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

## Voorbeeldantwoord

Opgenomen voorbeeld; velden en tellingen zijn afhankelijk van de bron en de gevraagde invoer.
```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"
}
```

## Responsvelden

| Veld | Type | Omschrijving |
| --- | --- | --- |
| source | string | De gevraagde API bron. |
| status | string | gedaan wanneer het real-time verzoek slaagt. |
| created_at | string | Aanmaaktijd voor respons in ISO 8601-formaat. |
| usage.credits | number | Credits in rekening gebracht voor het verzoek, op basis van uw plan. |
| results[0].searchParameters | object | Zoekinstellingen gerapporteerd door Google, met de query geregistreerd als q. Teruggeleverde instellingen kunnen afwijken van de gevraagde waarden. |
| results[0].places | array | Lokale zoekresultaten. |
| results[0].places[].title | string | Plaats of handelsnaam. |
| results[0].places[].address | string · optional | Straatadres. |
| results[0].places[].latitude | number · optional | Breedtegraad. |
| results[0].places[].longitude | number · optional | Lengtegraad. |
| results[0].places[].rating | number · optional | Gemiddelde waardering. |
| results[0].places[].ratingCount | integer · optional | Aantal ratings. |
| results[0].places[].category | string · optional | Bedrijfscategorie. |
| results[0].places[].phoneNumber | string · optional | Telefoonnummer vermeld. |
| results[0].places[].website | string · optional | Bedrijfswebsite. |
| results[0].places[].cid | string · optional | Google plaatsidentificatie. |
| results[0].places[].position | integer | Resultaatpositie. |
| results[0].places[].priceLevel | string · optional | Weergegeven prijsniveau indien beschikbaar. |

- Beschikbare velden zijn afhankelijk van het zoek- en zoektype. Optionele velden kunnen ontbreken en extra velden kunnen worden teruggegeven.
- Het aantal geretourneerde items en searchParameters.num kunnen afwijken van params.num. Gebruik de geretourneerde array om het werkelijke aantal resultaten te bepalen.

## Antwoordformaten

Antwoorden gebruiken JSON standaard. Kies een ander formaat met deze optionele headers.

- Accept: application/json (standaard) of text/plain. Platte tekst geeft dezelfde velden weer in een leesbare, ingespringde lay-out.
- X-Respond-With: markdown. Laat uitgevallen voor originele velden. Markdown werkt met beide responsformaten.

Markdown is beschikbaar voor real-time queries en voltooide resultaten.

De velden hieronder beschrijven de standaard JSON response.

[Voorbeelden van verzoeken en antwoorden](https://flashdata.dev/nl/docs/guides/response-formats/reference.md#headers)

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

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

## API-basisprincipes

De aanvraagbouwer en voorbeelden hierboven gebruiken de parameters van deze bron. Gebruik hieronder de voorbeelden Python en cURL voor gedeelde inzending, status en resultaatstappen. Een Batch body is een JSON object met queries; elk item geeft zijn eigen job ID terug.

- [Async verzoek en ontvangst](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#async)

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

- [Taakstatus controleren](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#status)

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

- [Gereedgemaakte resultaten ophalen](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON verzoeken](https://flashdata.dev/nl/docs/reference/batch-and-bulk/reference.md#batch)
- [Klant OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Aanmeldingen tot voltooiing

- [Ontvang en verifieer complete webhooks](https://flashdata.dev/nl/docs/guides/async-batch/reference.md#webhooks)

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

## Problemen oplossen

- [Fouten en statuscodes](https://flashdata.dev/nl/docs/errors/reference.md#status-codes)
- [Wanneer opnieuw proberen](https://flashdata.dev/nl/docs/errors/reference.md#retries)

## Gerelateerde API's

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