# WhatsApp-Standortnachrichten

Eine Standortnachricht sendet einen Pin: einen Punkt auf der Karte, optional mit Name und Adresse darunter. Dies ist die Sendeseite; um einen Kontakt stattdessen nach seinem Standort zu fragen, siehe [Standortanfragen](/docs/guides/whatsapp/message-types/interactive/location-requests).

## Standort senden

Setzen Sie `location.latitude` und `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](/de-de/dokumentation/guides/whatsapp/message-types/location.ts.md) · [Python](/de-de/dokumentation/guides/whatsapp/message-types/location.py.md) · [Go](/de-de/dokumentation/guides/whatsapp/message-types/location.go.md) · [PHP](/de-de/dokumentation/guides/whatsapp/message-types/location.php.md) · [CLI](/de-de/dokumentation/guides/whatsapp/message-types/location.cli.md) · [MCP](/de-de/dokumentation/guides/whatsapp/message-types/location.mcp.md) · [cURL](/de-de/dokumentation/guides/whatsapp/message-types/location.curl.md)

Die vollständige Struktur ergänzt `name` und `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` wird dem Empfänger nur angezeigt, wenn `name` ebenfalls gesetzt ist. `from` ist bei jeder Service-Nachricht erforderlich: eine Nummer, die Ihrem Workspace gehört, keine von Bird verwaltete.

## Limits

| Feld        | Grenze                                                               | Geprüft von               |
| ----------- | -------------------------------------------------------------------- | ------------------------- |
| `latitude`  | erforderlich, −90 bis 90, Dezimalgrad                                | Bird, bei Annahme (`422`) |
| `longitude` | erforderlich, −180 bis 180, Dezimalgrad                              | Bird, bei Annahme (`422`) |
| `name`      | optional, bis zu 1000 Zeichen                                        | Bird, bei Annahme (`422`) |
| `address`   | optional, bis zu 1000 Zeichen, nur angezeigt wenn `name` gesetzt ist | Bird, bei Annahme (`422`) |

Die eigene Dokumentation von WhatsApp führt `latitude` und `longitude` als erforderlich ohne angegebenen Wertebereich auf; die Bereichsprüfung ±90/±180 und die 1000-Zeichen-Limits für `name` und `address` sind eigene Grenzen von Bird.

## Eingehenden Standort lesen

Wenn ein Kontakt seinen Standort teilt, unaufgefordert oder als Antwort auf eine Standortanfrage, entsteht eine gewöhnliche eingehende `location`-Nachricht. Nichts daran ist garantiert: Ein nackter Pin kann ohne `name` und ganz ohne `address` ankommen, und ein eingehender Pin kann zusätzlich eine `url` mit Link zum Ort enthalten, die bei einem von Ihnen gesendeten Standort nie erscheint. Location ist kein Medientyp, es gibt also keine Datei zum Abrufen. Siehe [Eingehende WhatsApp-Standorte empfangen](/docs/guides/whatsapp/receiving-whatsapp/location) für den vollständigen eingehenden Lesevorgang, die `whatsapp.received`-Payload und worauf Sie achten sollten.

## Limits und Sonderfälle

- **Das Kundenservice-Fenster muss offen sein.** Ein Standortversand ist eine Service-Nachricht, die nur innerhalb eines offenen Fensters zustellbar ist; siehe das [Kundenservice-Fenster](/docs/guides/whatsapp/message-types#the-customer-service-window) im Hub.
- **`name` und `address` sind beim Lesen wirklich optional, nicht optional-mit-Fallback.** Ein nackter Pin hat keines von beiden, und `address` erscheint nie ohne `name`. Gehen Sie nicht davon aus, dass eine Adresse ein Koordinatenpaar begleitet.
- **Dies ist nicht derselbe Typ wie eine Standortanfrage.** [Standortanfragen](/docs/guides/whatsapp/message-types/interactive/location-requests) sind ein interaktiver Typ, der den Empfänger nach seinem eigenen Standort fragt; diese Seite sendet einen Standort an ihn. Verwechseln Sie die beiden Sendestrukturen nicht.
- **Ein Tippen auf eine Standortanfrage kommt als gewöhnliche eingehende `location`-Nachricht zurück, nicht als `interactive_reply`.** Eine Integration, die nur `interactive_reply` auf Taps überwacht, verpasst dies vollständig; sie muss auch eingehende `location` überwachen.

## Nächste Schritte

- [WhatsApp-Service-Nachrichten](/docs/guides/whatsapp/message-types): das Kundenservice-Fenster und das Modell, das alle Service-Nachrichten teilen
- [Standortanfragen](/docs/guides/whatsapp/message-types/interactive/location-requests): einen Kontakt nach seinem Standort fragen, statt einen zu senden
- [WhatsApp-Nachrichten senden](/docs/guides/whatsapp/sending-whatsapp): der Request-Envelope, das `202`-Modell und sicheres erneutes Versuchen

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