# Wiadomości lokalizacyjne WhatsApp

Wiadomość lokalizacyjna wysyła pinezkę: punkt na mapie z opcjonalną nazwą i adresem pod spodem. To strona wysyłania; jeśli chcesz poprosić kontakt o udostępnienie swojej lokalizacji, zobacz [żądania lokalizacji](/docs/guides/whatsapp/message-types/interactive/location-requests).

## Wyślij lokalizację

Ustaw `location.latitude` i `location.longitude`:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  location: { latitude: 37.7793, longitude: -122.4193 },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/pl-pl/dokumentacja/guides/whatsapp/message-types/location.ts.md) · [Python](/pl-pl/dokumentacja/guides/whatsapp/message-types/location.py.md) · [Go](/pl-pl/dokumentacja/guides/whatsapp/message-types/location.go.md) · [PHP](/pl-pl/dokumentacja/guides/whatsapp/message-types/location.php.md) · [CLI](/pl-pl/dokumentacja/guides/whatsapp/message-types/location.cli.md) · [MCP](/pl-pl/dokumentacja/guides/whatsapp/message-types/location.mcp.md) · [cURL](/pl-pl/dokumentacja/guides/whatsapp/message-types/location.curl.md)

Pełna struktura dodaje `name` i `address`:

```json
{
  "to": "+16505551234",
  "from": "+13124495648",
  "location": {
    "latitude": 37.7793,
    "longitude": -122.4193,
    "name": "Ferry Building Pickup",
    "address": "1 Market St, San Francisco, CA 94105"
  }
}
```

`address` wyświetla się odbiorcy tylko wtedy, gdy `name` jest również ustawione. `from` jest wymagane w każdej wiadomości serwisowej: numer należący do Twojego obszaru roboczego, a nie zarządzany przez Bird.

## Limity

| Pole        | Ograniczenie                                                            | Wymuszane przez               |
| ----------- | ----------------------------------------------------------------------- | ----------------------------- |
| `latitude`  | wymagane, od -90 do 90, stopnie dziesiętne                              | Bird, przy akceptacji (`422`) |
| `longitude` | wymagane, od -180 do 180, stopnie dziesiętne                            | Bird, przy akceptacji (`422`) |
| `name`      | opcjonalne, do 1000 znaków                                              | Bird, przy akceptacji (`422`) |
| `address`   | opcjonalne, do 1000 znaków, wyświetlane tylko gdy `name` jest ustawione | Bird, przy akceptacji (`422`) |

Dokumentacja WhatsApp wymienia `latitude` i `longitude` jako wymagane, bez podanego zakresu liczbowego; sprawdzenie zakresu ±90/±180 oraz limity 1000 znaków na `name` i `address` to własne ograniczenia Bird.

## Odczyt przychodzących lokalizacji

Kontakt udostępniający swoją lokalizację, spontanicznie lub w odpowiedzi na żądanie lokalizacji, generuje zwykłą przychodzącą wiadomość `location`. Nic w niej nie jest gwarantowane: sama pinezka może dotrzeć bez `name` i bez `address`, a przychodząca lokalizacja może też zawierać `url` prowadzący do miejsca, który nigdy nie pojawia się w lokalizacji wysyłanej przez Ciebie. Lokalizacja nie jest typem mediów, więc nie ma pliku do pobrania. Zobacz [Odbieranie lokalizacji WhatsApp](/docs/guides/whatsapp/receiving-whatsapp/location), aby poznać pełny odczyt przychodzący, ładunek `whatsapp.received` i na co zwrócić uwagę.

## Limity i przypadki brzegowe

- **Okno obsługi klienta musi być otwarte.** Wysłanie lokalizacji to wiadomość serwisowa, dostarczana tylko w otwartym oknie; zobacz [okno obsługi klienta](/docs/guides/whatsapp/message-types#the-customer-service-window) w hubie.
- **`name` i `address` są naprawdę opcjonalne przy odczycie, a nie opcjonalne z wartością zastępczą.** Sama pinezka nie zawiera żadnego z nich, a `address` nigdy nie pojawia się bez `name`. Nie zakładaj, że do pary współrzędnych dołączony jest adres.
- **To nie jest ten sam typ co żądanie lokalizacji.** [Żądania lokalizacji](/docs/guides/whatsapp/message-types/interactive/location-requests) to typ interaktywny, który prosi odbiorcę o jego lokalizację; ta strona opisuje wysyłanie lokalizacji do niego. Nie mieszaj tych dwóch struktur wysyłania.
- **Dotknięcie żądania lokalizacji wraca jako zwykła przychodząca wiadomość `location`, a nie `interactive_reply`.** Integracja obserwująca tylko `interactive_reply` w poszukiwaniu dotknięć całkowicie to pomija; musi również obserwować przychodzące `location`.

## Następne kroki

- [Wiadomości serwisowe WhatsApp](/docs/guides/whatsapp/message-types): okno obsługi klienta i model wspólny dla wszystkich wiadomości serwisowych
- [Żądania lokalizacji](/docs/guides/whatsapp/message-types/interactive/location-requests): poproś kontakt o lokalizację zamiast wysyłać swoją
- [Wysyłanie wiadomości WhatsApp](/docs/guides/whatsapp/sending-whatsapp): koperta żądania, model `202` i bezpieczne ponawianie

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