> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zavu.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Location Messages

> Share locations via WhatsApp

Share geographic locations with users to help them find your store, delivery points, or event venues.

## Send a Location

<CodeGroup>
  ```typescript TypeScript theme={null}
  const message = await zavu.messages.send({
    to: "+14155551234",
    channel: "whatsapp",
    messageType: "location",
    content: {
      latitude: 37.7749,
      longitude: -122.4194,
      locationName: "Zavu HQ",
      locationAddress: "123 Market Street, San Francisco, CA"
    }
  });
  ```

  ```python Python theme={null}
  message = zavu.messages.send(
      to="+14155551234",
      channel="whatsapp",
      message_type="location",
      content={
          "latitude": 37.7749,
          "longitude": -122.4194,
          "location_name": "Zavu HQ",
          "location_address": "123 Market Street, San Francisco, CA"
      }
  )
  ```

  ```ruby Ruby theme={null}
  message = client.messages.send(
    to: "+14155551234",
    channel: "whatsapp",
    message_type: "location",
    content: {
      latitude: 37.7749,
      longitude: -122.4194,
      location_name: "Zavu HQ",
      location_address: "123 Market Street, San Francisco, CA"
    }
  )
  ```

  ```go Go theme={null}
  message, err := client.Messages.Send(context.TODO(), zavudev.MessageSendParams{
      To:          zavudev.String("+14155551234"),
      Channel:     zavudev.String("whatsapp"),
      MessageType: zavudev.String("location"),
      Content: &zavudev.MessageContentParams{
          Latitude:        zavudev.Float64(37.7749),
          Longitude:       zavudev.Float64(-122.4194),
          LocationName:    zavudev.String("Zavu HQ"),
          LocationAddress: zavudev.String("123 Market Street, San Francisco, CA"),
      },
  })
  ```

  ```php PHP theme={null}
  $message = $client->messages->send([
      'to' => '+14155551234',
      'channel' => 'whatsapp',
      'messageType' => 'location',
      'content' => [
          'latitude' => 37.7749,
          'longitude' => -122.4194,
          'locationName' => 'Zavu HQ',
          'locationAddress' => '123 Market Street, San Francisco, CA',
      ],
  ]);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.zavu.dev/v1/messages \
    -H "Authorization: Bearer zv_live_xxx" \
    -H "Content-Type: application/json" \
    -d '{
      "to": "+14155551234",
      "channel": "whatsapp",
      "messageType": "location",
      "content": {
        "latitude": 37.7749,
        "longitude": -122.4194,
        "locationName": "Zavu HQ",
        "locationAddress": "123 Market Street, San Francisco, CA"
      }
    }'
  ```
</CodeGroup>

## Specifications

| Property        | Requirement                      |
| --------------- | -------------------------------- |
| latitude        | Required, -90 to 90              |
| longitude       | Required, -180 to 180            |
| locationName    | Optional, name displayed to user |
| locationAddress | Optional, full address           |

<Tip>
  Include both `locationName` and `locationAddress` for the best user experience. Users can tap the location to open it in their maps app.
</Tip>

## Use Cases

* Store locations
* Delivery drop-off points
* Event venues
* Meeting locations
* Service center addresses