发送位置消息

发送地理位置卡片。

请求参数

参数	必填	类型	说明
`appid`	是	`string`	实例 appid，标识操作哪个已登录账号。示例：`we_xxxxxxxxxxxxxxx`
`conversationId`	是	`int64`	会话 id：单聊传对方 `userId`，群聊传 `roomId`，给自己发传当前账号 `uin`；必须是 JSON number。示例：`10786447466811918`
`content`	是	`object`	消息内容，子字段见下。示例：`{"longitude":121.12781,"latitude":31.148475,"address":"上海…`

content 字段

字段	类型	说明
`content.longitude`	`number`	经纬度
`content.latitude`	`number`	经纬度
`content.address`	`string`	地址与标题
`content.title`	`string`	地址与标题

请求示例

http

POST {BASE_URL}/wx-api/api/message/sendLocation
Authorization: Bearer <你的 App Token>
Content-Type: application/json

{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "longitude": 121.12781,
    "latitude": 31.148475,
    "address": "上海市青浦区桂花园(外青松公路东100米)",
    "title": "青浦区桂花园(外青松公路东100米)"
  }
}

bash

curl -X POST '{BASE_URL}/wx-api/api/message/sendLocation' \
  -H 'Authorization: Bearer <你的 App Token>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "longitude": 121.12781,
    "latitude": 31.148475,
    "address": "上海市青浦区桂花园(外青松公路东100米)",
    "title": "青浦区桂花园(外青松公路东100米)"
  }
}'

python

import requests

url = "{BASE_URL}/wx-api/api/message/sendLocation"
headers = {"Authorization": "Bearer <你的 App Token>", "Content-Type": "application/json"}
body = """{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "longitude": 121.12781,
    "latitude": 31.148475,
    "address": "上海市青浦区桂花园(外青松公路东100米)",
    "title": "青浦区桂花园(外青松公路东100米)"
  }
}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)

java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String url = "{BASE_URL}/wx-api/api/message/sendLocation";
String body = "{\n" +
    "  \"appid\": \"we_xxxxxxxxxxxxxxx\",\n" +
    "  \"conversationId\": 10786447466811918,\n" +
    "  \"content\": {\n" +
    "    \"longitude\": 121.12781,\n" +
    "    \"latitude\": 31.148475,\n" +
    "    \"address\": \"上海市青浦区桂花园(外青松公路东100米)\",\n" +
    "    \"title\": \"青浦区桂花园(外青松公路东100米)\"\n" +
    "  }\n" +
    "}";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的 App Token>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

php

<?php

$url = '{BASE_URL}/wx-api/api/message/sendLocation';
$body = <<<'JSON'
{
  "appid": "we_xxxxxxxxxxxxxxx",
  "conversationId": 10786447466811918,
  "content": {
    "longitude": 121.12781,
    "latitude": 31.148475,
    "address": "上海市青浦区桂花园(外青松公路东100米)",
    "title": "青浦区桂花园(外青松公路东100米)"
  }
}
JSON;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的 App Token>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

响应示例

响应结构与发送文本消息相同

成功时 data 就是刚发出的完整消息，字段见发送文本消息的响应示例。data.content 回显你发送的内容或上传字段，形状随消息类型不同，见消息模块总览的码表。

响应字段

字段	类型	说明
`code`	`int64`	统一封套状态码：0=成功，负数=失败
`detail`	`string`	附加明细，通常为空
`message`	`string`	文案：成功为 ok；失败形如 -码\|描述
`time`	`string`	服务端处理时间 YYYY-MM-DD HH:MM:SS

常见错误

下表为企微错误码。业务失败时顶层 code=-1，具体错误码在 message 的 | 前，例如 -3004|参数错误；鉴权与网关错误见错误码。

错误码	含义	怎么办
`-4014`	过期或错误的 `uin` 作 `conversationId`	先 `personal/getInfo` 取当前 `uin`
`-3020`	用自聊伪房间 `roomId` 作发送目标	给自己发用当前账号 `uin`
`-3004`	参数错误	检查字段名与类型，数字 id 不能传字符串

发送位置消息 ​

请求参数 ​

请求示例 ​

响应示例 ​

响应字段 ​

常见错误 ​

下一步 ​