# WhatsApp-locatieberichten

Een locatiebericht stuurt een pin: een punt op de kaart, met een optionele naam en adres eronder. Dit is de verzendzijde; om een contact te vragen hun locatie te delen, zie [locatieverzoeken](/docs/guides/whatsapp/message-types/interactive/location-requests).

## Een locatie versturen

Stel `location.latitude` en `location.longitude` in:

**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](/nl-nl/documentatie/guides/whatsapp/message-types/location.ts.md) · [Python](/nl-nl/documentatie/guides/whatsapp/message-types/location.py.md) · [Go](/nl-nl/documentatie/guides/whatsapp/message-types/location.go.md) · [PHP](/nl-nl/documentatie/guides/whatsapp/message-types/location.php.md) · [CLI](/nl-nl/documentatie/guides/whatsapp/message-types/location.cli.md) · [MCP](/nl-nl/documentatie/guides/whatsapp/message-types/location.mcp.md) · [cURL](/nl-nl/documentatie/guides/whatsapp/message-types/location.curl.md)

De volledige vorm voegt `name` en `address` toe:

```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` wordt alleen aan de ontvanger getoond als `name` ook is ingesteld. `from` is verplicht bij elk servicebericht: een nummer dat je werkruimte bezit, niet een door Bird beheerd nummer.

## Limieten

| Veld        | Grens                                                                   | Afgedwongen door             |
| ----------- | ----------------------------------------------------------------------- | ---------------------------- |
| `latitude`  | verplicht, -90 tot 90, decimale graden                                  | Bird, bij acceptatie (`422`) |
| `longitude` | verplicht, -180 tot 180, decimale graden                                | Bird, bij acceptatie (`422`) |
| `name`      | optioneel, maximaal 1000 tekens                                         | Bird, bij acceptatie (`422`) |
| `address`   | optioneel, maximaal 1000 tekens, alleen getoond als `name` is ingesteld | Bird, bij acceptatie (`422`) |

De eigen documentatie van WhatsApp vermeldt `latitude` en `longitude` als verplicht zonder een expliciet numeriek bereik; de ±90/±180 bereikcontrole en de limiet van 1000 tekens op `name` en `address` zijn eigen grenzen van Bird.

## Een inkomende locatie lezen

Als een contact hun locatie deelt, spontaan of als antwoord op een locatieverzoek, levert dat een gewoon inkomend `location`-bericht op. Niets eraan is gegarandeerd: een kale pin kan binnenkomen zonder `name` en zonder `address`, en een inkomende pin kan ook een `url` bevatten die naar de locatie linkt, wat nooit verschijnt bij een locatie die je verstuurt. Locatie is geen mediatype, dus er is geen bestand om op te halen. Zie [Inkomende WhatsApp-locaties ontvangen](/docs/guides/whatsapp/receiving-whatsapp/location) voor het volledige inkomende bericht, de `whatsapp.received`-payload, en waar je op moet letten.

## Limieten en randgevallen

- **Het klantenservicevenster moet open zijn.** Een locatieverzending is een servicebericht, alleen afleverbaar binnen een geopend venster; zie het [klantenservicevenster](/docs/guides/whatsapp/message-types#the-customer-service-window) van de hub.
- **`name` en `address` zijn bij het lezen echt optioneel, niet optioneel-met-een-terugval.** Een kale pin heeft geen van beide, en `address` verschijnt nooit zonder `name`. Ga er niet van uit dat een straatnaam bij een coördinatenpaar hoort.
- **Dit is niet hetzelfde type als een locatieverzoek.** [Locatieverzoeken](/docs/guides/whatsapp/message-types/interactive/location-requests) zijn een interactief type dat de ontvanger om hun eigen locatie vraagt; deze pagina verstuurt er een naar hen. Verwar de twee verzendvormen niet met elkaar.
- **Een tik op een locatieverzoek komt terug als een gewoon inkomend `location`-bericht, niet als een `interactive_reply`.** Een integratie die alleen `interactive_reply` controleert op tikken mist dit volledig; je moet ook inkomende `location` monitoren.

## Volgende stappen

- [WhatsApp-serviceberichten](/docs/guides/whatsapp/message-types): het klantenservicevenster en het model dat elk servicebericht deelt
- [Locatieverzoeken](/docs/guides/whatsapp/message-types/interactive/location-requests): vraag een contact om hun locatie in plaats van er een te versturen
- [WhatsApp-berichten versturen](/docs/guides/whatsapp/sending-whatsapp): de request-envelope, het `202`-model en veilig opnieuw proberen

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