Location Message

A location message is a message that contains geographical information such as a map or a link to a map. You can send a location message by making a POST request to the /messages:send Conversation API endpoint with the following payload:

{
  "app_id": "{{APP_ID}}",
  "recipient": {
    "contact_id": "{{CONTACT_ID}}"
  },
  "message": {
    "location_message": {
      "title": "Your ride is here!",
      "label": "Meet your driver at the specified address.",
      "coordinates": {
        "latitude": 55.610479,
        "longitude": 13.002873
      }
    }
  }
}

The follow sections give examples of how location messages are rendered in each channel.

WhatsApp

WhatsApp channel natively supports location messages. The following image gives an example of a location message.

Location Message

SMS

SMS supports Location messages natively. The following image gives an example of a location message.

Location Message

Facebook Messenger

Facebook Messenger supports location messages natively. The following image gives an example of a location message.

Location Message

Instagram

Instagram doesn't natively support location messages. The location message is transcoded as a text message which contains a URL that points to the Google Maps app.

MMS

MMS doesn't natively support location messages, and so they're transcoded and sent as text messages by Conversation API.

The following image gives an example of a location message.

Location Message

RCS

RCS channel doesn't natively support Location Messages. You can simply put your coordinates in a message body and Conversation API transcodes it into a text message with one Location Choice.

The following image gives an example of a location message.

Location Message

Viber Bot

Viber Bot channel natively supports location messages. The following image gives an example of a location message.

Location Message

Viber Business Messages

Viber Business Messages channel doesn't natively support location messages and so they're transcoded and sent as text messages by Conversation API. The following image gives an example of a location message.

Location Message

Telegram

Telegram channel natively supports location messages.

Location Message

Kakaotalk

Kakaotalk doesn't natively support location messages, and so they're transcoded and sent as text messages by Conversation API.

The Location message as text (including title, label, url) has a maximum length of 1000 characters.