# FlashData Google Places API

स्थानीय व्यवसायों और स्थानों के लिए खोजें। उपलब्ध होने पर नाम, पते, निर्देशांक, रेटिंग और संपर्क विवरण पुनर्प्राप्त करें।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/sources/google_places
समीक्षित: 2026-10-23

समापन बिंदु: POST https://data.flashdata.dev/v1/queries/realtime
प्रमाणीकरण: X-API-Key: YOUR_API_KEY
मोड: [Realtime](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/hi/docs/reference/batch-and-bulk/reference.md#batch)

आवश्यक स्रोत अनुमति: google_places

YOUR_API_KEY को API कुंजी के साथ बदलें जिसमें इस स्रोत की अनुमति और उपलब्ध क्रेडिट हैं। अपने सर्वर या एजेंट होस्ट पर अनुरोध चलाएं।

[प्रमाणीकरण सेट करें](https://flashdata.dev/hi/docs/guides/headers-and-authentication/reference.md)

[एक Google खोज को चुनें और परिष्कृत करें](https://flashdata.dev/hi/docs/guides/google-search-guide/reference.md)

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

## एक अनुरोध भेजें

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

## पैरामीटर

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

### अनुरोध का मुख्य भाग

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | हाँ | — | google_places को सेट करें।  |
| <a id="parameter-query"></a> query | string | हाँ | सेट नहीं | क्वेरी खोजें। इस तरह के साइट के रूप में Google खोज ऑपरेटरों का समर्थन करता है: और intitle: न्यूनतम लंबाई: 1 अधिकतम लंबाई: 2000 |
| <a id="parameter-params"></a> params | object | नहीं | {} | इस अनुरोध के लिए Settings  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | नहीं | सेट नहीं | केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।  |

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

### देश, भाषा और स्थान

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | नहीं | सेट नहीं | दो-अक्षर देश कोड, जैसे कि हम, जीबी, डी या एसजी। एक देश का चयन करने के लिए स्पष्ट रूप से सेट करें। न्यूनतम लंबाई: 2 अधिकतम लंबाई: 2 पैटर्न: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | नहीं | सेट नहीं | Google इंटरफ़ेस भाषा। एक भाषा का चयन करने के लिए स्पष्ट रूप से सेट करें। न्यूनतम लंबाई: 1 अधिकतम लंबाई: 35 पैटर्न: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | नहीं | सेट नहीं | अनुरोधित खोज स्थान, अधिमानतः एक शहर, जैसे "London, England, United Kingdom"। उपलब्धता खोज प्रकार पर निर्भर करती है। न्यूनतम लंबाई: 1 अधिकतम लंबाई: 200 |

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

### पगिनेशन

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | नहीं | सेट नहीं | अनुरोधित परिणाम गिनती। FlashData एक निश्चित डिफ़ॉल्ट नहीं है जब omitted है। वापसी की गिनती क्वेरी और खोज प्रकार से भिन्न हो सकती है। न्यूनतम: 1 अधिकतम: 100 |
| <a id="parameter-params-page"></a> params.page | integer | नहीं | सेट नहीं | अनुरोधित परिणाम पृष्ठ। स्पष्ट रूप से सेट करें। प्रत्येक पृष्ठ एक अलग API अनुरोध है। न्यूनतम: 1 अधिकतम: 100 |

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

### फ़िल्टर खोजें

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | नहीं | सेट नहीं | अनुरोधित Google खोज फ़िल्टर, जैसे कि Qdr:d पिछले दिन या qdr: w के लिए पिछले सप्ताह के लिए। उपलब्धता खोज प्रकार पर निर्भर करती है। न्यूनतम लंबाई: 1 अधिकतम लंबाई: 200 |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | नहीं | सेट नहीं | true के साथ वर्तनी सुधार का अनुरोध करें या इसे false के साथ अक्षम करने का अनुरोध करें। एप्लाइड व्यवहार खोज के प्रकार पर निर्भर करता है; Google के व्यवहार का उपयोग करने के लिए मत।  |

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

## परिणाम पढ़ें

सफल JSON प्रतिक्रिया को response.json के रूप में सहेजें। इसे read-response.py के रूप में सहेजें और python read-response.py चलाएं। यह केवल Python के मानक पुस्तकालय का उपयोग करता है और कोई नया अनुरोध नहीं करता है।

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

## उदाहरण जवाब

रिकॉर्ड उदाहरण; फ़ील्ड और गिनती स्रोत पर निर्भर करती है और इनपुट का अनुरोध करती है।
```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"
}
```

## प्रतिक्रिया क्षेत्र

| फील्ड | प्रकार | विवरण |
| --- | --- | --- |
| source | string | अनुरोधित API स्रोत। |
| status | string | जब रियलटाइम अनुरोध सफल होता है तो किया जाता है। |
| created_at | string | ISO 8601 प्रारूप में प्रतिक्रिया निर्माण समय। |
| usage.credits | number | आपकी योजना के आधार पर अनुरोध के लिए शुल्क लिया गया क्रेडिट। |
| results[0].searchParameters | object | खोज सेटिंग्स की रिपोर्ट Google द्वारा की गई है, जिसमें क्वेरी Q के रूप में दर्ज की गई है। रिटर्न सेटिंग्स अनुरोधित मूल्यों से भिन्न हो सकती है। |
| results[0].places | array | स्थानीय खोज परिणाम। |
| results[0].places[].title | string | स्थान या व्यापारिक नाम। |
| results[0].places[].address | string · optional | सड़क का पता |
| results[0].places[].latitude | number · optional | अक्षांश। |
| results[0].places[].longitude | number · optional | अक्षांश। |
| results[0].places[].rating | number · optional | औसत रेटिंग। |
| results[0].places[].ratingCount | integer · optional | रेटिंग की संख्या। |
| results[0].places[].category | string · optional | व्यवसाय श्रेणी |
| results[0].places[].phoneNumber | string · optional | सूचीबद्ध फ़ोन नंबर। |
| results[0].places[].website | string · optional | व्यापार वेबसाइट। |
| results[0].places[].cid | string · optional | Google स्थान पहचानकर्ता। |
| results[0].places[].position | integer | परिणाम स्थिति। |
| results[0].places[].priceLevel | string · optional | उपलब्ध होने पर प्रदर्शित मूल्य स्तर। |

- उपलब्ध फ़ील्ड क्वेरी और खोज प्रकार पर निर्भर करती हैं। वैकल्पिक फ़ील्ड अनुपस्थित हो सकते हैं और अतिरिक्त फ़ील्ड वापस आ सकते हैं।
- लौटाने वाले आइटम और searchParameters.num की संख्या params.num से भिन्न हो सकती है। वास्तविक परिणाम गिनती निर्धारित करने के लिए रिटर्न की सरणी का उपयोग करें।

## जवाब के फ़ॉर्मैट

उत्तर डिफ़ॉल्ट रूप से JSON का उपयोग करते हैं। इन वैकल्पिक शीर्षलेखों के साथ एक और प्रारूप चुनें।

- Accept: application/json (डिफ़ॉल्ट) या text/plain. सादा पाठ एक पठनीय, इंडेंट लेआउट में समान फ़ील्ड प्रस्तुत करता है।
- X-Respond-With: markdown. मूल क्षेत्रों के लिए unset छोड़ दें। Markdown या तो प्रतिक्रिया प्रारूप के साथ काम करता है।

Markdown वास्तविक समय के प्रश्नों और पूर्ण परिणाम के लिए उपलब्ध है।

नीचे दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं।

[अनुरोध और प्रतिक्रिया प्रारूप उदाहरण](https://flashdata.dev/hi/docs/guides/response-formats/reference.md#headers)

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

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

## API की बुनियादी बातें

अनुरोध बिल्डर और उपरोक्त उदाहरण इस स्रोत के पैरामीटर का उपयोग करते हैं। साझा प्रस्तुतीकरण, स्थिति और परिणाम चरणों के लिए नीचे Python और cURL उदाहरणों का उपयोग करें। एक Batch शरीर एक JSON वस्तु है जिसमें क्वेरीज़ शामिल है; प्रत्येक आइटम अपने खुद के काम को लौटा देता है ID.

- [Async अनुरोध और रसीद](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#async)

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

- [नौकरी की स्थिति चेक करें](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#status)

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

- [प्राप्त करने के परिणाम](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON अनुरोध](https://flashdata.dev/hi/docs/reference/batch-and-bulk/reference.md#batch)
- [ग्राहक OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## पूर्णता अधिसूचना

- [पूरा वेबहुक प्राप्त करना और सत्यापित करना](https://flashdata.dev/hi/docs/guides/async-batch/reference.md#webhooks)

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

## समस्या निवारण

- [त्रुटियाँ और स्टेटस कोड](https://flashdata.dev/hi/docs/errors/reference.md#status-codes)
- [कब्ज़ा](https://flashdata.dev/hi/docs/errors/reference.md#retries)

## संबंधित एपीआई

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