# WhatsApp लोकेशन प्राप्त करना

किसी कॉन्टैक्ट द्वारा शेयर किया गया पिन `location` के साथ इनबाउंड मैसेज के रूप में आता है। यही arm आपके भेजे गए [लोकेशन रिक्वेस्ट](/docs/guides/whatsapp/message-types/interactive/location-requests) का जवाब भी देता है, जो एकमात्र इंटरैक्टिव टाइप है जिसका रिप्लाई `interactive_reply` के बजाय यहाँ आता है।

## इनबाउंड लोकेशन में क्या होता है

```json
{
  "id": "wam_01kyf8u2shzx0v6m9q3bag8tje",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
  "location": {
    "latitude": 37.7793,
    "longitude": -122.4193,
    "name": "Embarcadero Plaza",
    "address": "1 Market St, San Francisco, CA 94105"
  },
  "created_at": "2026-08-25T09:23:14Z"
}
```

| फ़ील्ड      | इसमें क्या होता है                                                            |
| ----------- | ----------------------------------------------------------------------------- |
| `latitude`  | दशमलव डिग्री में अक्षांश                                                      |
| `longitude` | दशमलव डिग्री में देशांतर                                                      |
| `name`      | स्थान का नाम; जब कॉन्टैक्ट ने सादा पिन शेयर किया हो तो अनुपस्थित              |
| `address`   | सड़क का पता, जो WhatsApp केवल `name` के साथ भेजता है                          |
| `url`       | स्थान का लिंक, मुख्यतः बिज़नेस लोकेशन पर, जब भेजने वाले के क्लाइंट ने दिया हो |

मैप पर ड्रॉप किया गया सादा पिन केवल दो निर्देशांक रखता है और कुछ नहीं, इसलिए `name`, `address`, और `url` को ऐसी सजावट मानें जो मौजूद होने पर दिखाएँ, न कि ऐसे फ़ील्ड जिन पर निर्भर रहें। निर्देशांकों को JSON नंबर के रूप में पढ़ें, और दक्षिणी व पश्चिमी गोलार्धों में ऋणात्मक मान की अपेक्षा रखें।

## लोकेशन रिक्वेस्ट का जवाब देने वाली लोकेशन

जब पिन आपके भेजे गए लोकेशन रिक्वेस्ट का जवाब देता है, तो WhatsApp उस अनुरोध को रिप्लाई के टारगेट के रूप में रिपोर्ट करता है और `in_reply_to_message_id` उस मैसेज को नाम देता है जिसमें बटन था। यही किसी जवाब को सवाल से जोड़ता है, और यही [कॉन्टैक्ट इन्फ़ो रिक्वेस्ट](/docs/guides/whatsapp/message-types/interactive/contact-info-requests) से अंतर है, जिसके रिप्लाई में ऐसा कोई लिंक नहीं होता।

पिन को जवाब के रूप में और कुछ नहीं चिह्नित करता। बिना माँगे अपनी लोकेशन शेयर करने वाला कॉन्टैक्ट भी वही arm बनाता है जिसमें `in_reply_to_message_id` नहीं होता, इसलिए जवाब की निगरानी करने वाला इंटीग्रेशन arm के बजाय उस फ़ील्ड की जाँच करता है। यह फ़ील्ड दूसरी दिशा में गारंटी नहीं है: WhatsApp हर रिप्लाई को चिह्नित नहीं करता, और रिज़ॉल्यूशन चूक सकता है, इसलिए एक वास्तविक जवाब बिना इसके भी आ सकता है। हब का [quoted replies](/docs/guides/whatsapp/receiving-whatsapp#quoted-replies) बताता है कि ऐसा कब होता है और जहाँ वर्गीकरण सही होना ज़रूरी है वहाँ क्या करें।

## वेबहुक पेलोड

`whatsapp.received` इवेंट एनवेलप पर `location` arm रखता है:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:23:14.507Z",
  "data": {
    "whatsapp_id": "wam_01kyf8u2shzx0v6m9q3bag8tje",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "in_reply_to_message_id": "wam_01kya19eknftrs2s6p82asmvnh",
    "location": {
      "latitude": 37.7793,
      "longitude": -122.4193,
      "name": "Embarcadero Plaza",
      "address": "1 Market St, San Francisco, CA 94105"
    },
    "tags": null,
    "metadata": null
  }
}
```

## ध्यान देने योग्य बातें

- **लाइव लोकेशन शेयरिंग को कंटेंट के रूप में मॉडल नहीं किया गया है।** जो आता है वह एक समय पर स्थिर एक लोकेशन है, इसलिए ट्रैकिंग व्यू के पास अपडेट करने को कुछ नहीं होता। इस फ़ील्ड पर ट्रैकिंग न बनाएँ।
- **केवल `interactive_reply` देखने वाला इंटीग्रेशन इसे चूक जाता है।** लोकेशन रिक्वेस्ट का जवाब यहाँ आता है, और कॉन्टैक्ट इन्फ़ो रिक्वेस्ट का जवाब `contact_cards` पर आता है, इसलिए केवल टैप पढ़ने वाला हैंडलर दोनों को छोड़ देता है।
- **निर्देशांक वही हैं जो कॉन्टैक्ट के डिवाइस ने रिपोर्ट किए।** इनमें कोई सटीकता त्रिज्या या ऊँचाई नहीं होती, और कॉन्टैक्ट ने जो पिन खींचा वह वहीं है जहाँ उन्होंने खींचा। जब पता सही होना ज़रूरी हो तो शब्दों में पुष्टि करें।

## अगले कदम

- [रिसीविंग कैसे काम करती है](/docs/guides/whatsapp/receiving-whatsapp): इनबाउंड एनवेलप, मीडिया फ़ेचिंग, और `whatsapp.received` वेबहुक
- [WhatsApp लोकेशन मैसेज](/docs/guides/whatsapp/message-types/location): इसी arm का सेंड साइड
- [WhatsApp लोकेशन रिक्वेस्ट](/docs/guides/whatsapp/message-types/interactive/location-requests): पिन माँगने वाला बटन
- [WhatsApp इवेंट](/docs/guides/whatsapp/events): पूरी इवेंट सूची, API या वेबहुक के ज़रिए

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)