教程——博客中获取访问者位置（精确到区）

博客中获取访问者位置教程（精确到区）

image-20251104212011083

一、注册并配置腾讯定位工具

简单来说，这一步是为了获取一个专属密钥（Key），让腾讯地图帮我们识别访客位置。

  1. 注册并创建应用

    • 打开 腾讯定位工具官网，注册账号后进入「我的应用」→「创建应用」。
    • 应用名称、类型随便填（比如 “我的博客定位”“个人网站”）。

  2. 创建 Key（关键步骤）

    • 进入新应用，点击「添加 Key」：

      • Key 名称随便起（比如 “博客访客定位”）；

      • 产品选「WebServiceAPI」；

      • 域名白名单

        必须填两个：

        • 你的线上博客域名（全部小写）；
        • 本地预览地址localhost:4000（Hexo 本地预览的端口）；

      • 保存后记下生成的 6*5 字符 Key（后续要替换到代码里）。

  3. 配置配额（否则可能无法使用）

    • 点击左侧「配额管理」→「账户额度」→ 找到「IP 定位」；

    • 点击「配额分配」，把 IP 定位的调用额度拉满（一天 10000 次足够小网站用），保存即可。

      image-20251104203019231

二、配置 JS 文件（实现访客定位与欢迎语）

新建一个 JS 文件，让它负责请求腾讯 API 获取位置、计算距离、显示个性化欢迎语。

  1. 新建并编写txmap.js
    • 在博客根目录的source/js/文件夹下（没有js文件夹就新建），新建txmap.js，复制以下代码，注意替换两处关键信息：
      • key: '你的腾讯Key'：把第一步得到的 Key 填进去；
      • getDistance(你的经度, 你的纬度, ...)：把你博客所在位置的经纬度替换进去（比如武汉的经纬度是114.3493, 30.5067，可以在地图上搜索自己的城市获取）。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
//get请求
jQuery.ajax({
    type: 'get',
    url: 'https://apis.map.qq.com/ws/location/v1/ip',
    data: {
        key: 'NXFBZ-WWCKQ-3L75X-BF47W-HMDSJ-UCBFT',  //这里进行替换
        output: 'jsonp',
    },
    dataType: 'jsonp',
    success: function (res) {
        console.log(res);
        ipLoacation = res;
        console.log(ipLoacation);
    }
})
function getDistance(e1, n1, e2, n2) {
    const R = 6371
    const { sin, cos, asin, PI, hypot } = Math
    let getPoint = (e, n) => {
        e *= PI / 180
        n *= PI / 180
        return { x: cos(n) * cos(e), y: cos(n) * sin(e), z: sin(n) }
    }

    let a = getPoint(e1, n1)
    let b = getPoint(e2, n2)
    let c = hypot(a.x - b.x, a.y - b.y, a.z - b.z)
    let r = asin(c / 2) * 2 * R
    return Math.round(r);
}

function showWelcome() {

    let dist = getDistance(114.25816, 30.43798, ipLoacation.result.location.lng, ipLoacation.result.location.lat); //这里换成自己的经纬度
    let pos = ipLoacation.result.ad_info.nation;
    let ip;
    let posdesc;
    //根据国家、省份、城市信息自定义欢迎语
    switch (ipLoacation.result.ad_info.nation) {
        case "日本":
            posdesc = "よろしく，一起去看樱花吗";
            break;
        case "美国":
            posdesc = "Let us live in peace!";
            break;
        case "英国":
            posdesc = "想同你一起夜乘伦敦眼";
            break;
        case "俄罗斯":
            posdesc = "干了这瓶伏特加！";
            break;
        case "法国":
            posdesc = "C'est La Vie";
            break;
        case "德国":
            posdesc = "Die Zeit verging im Fluge.";
            break;
        case "澳大利亚":
            posdesc = "一起去大堡礁吧！";
            break;
        case "加拿大":
            posdesc = "拾起一片枫叶赠予你";
            break;
        case "中国":
            pos = ipLoacation.result.ad_info.province + " " + ipLoacation.result.ad_info.city + " " + ipLoacation.result.ad_info.district;
            ip = ipLoacation.result.ip;
            switch (ipLoacation.result.ad_info.province) {
                case "北京市":
                    posdesc = "北——京——欢迎你~~~";
                    break;
                case "天津市":
                    posdesc = "讲段相声吧。";
                    break;
                case "河北省":
                    posdesc = "山势巍巍成壁垒，天下雄关。铁马金戈由此向，无限江山。";
                    break;
                case "山西省":
                    posdesc = "展开坐具长三尺，已占山河五百余。";
                    break;
                case "内蒙古自治区":
                    posdesc = "天苍苍，野茫茫，风吹草低见牛羊。";
                    break;
                case "辽宁省":
                    posdesc = "请我吃烤鸡架！";
                    break;
                case "吉林省":
                    posdesc = "状元阁就是东北烧烤之王。";
                    break;
                case "黑龙江省":
                    posdesc = "带我去冰雪大世界吧hhhh。";
                    break;
                case "上海市":
                    posdesc = "众所周知，中国只有两个城市。";
                    break;
                case "江苏省":
                    switch (ipLoacation.result.ad_info.city) {
                        case "南京市":
                            posdesc = "看来我们离得还挺近嗷！";
                            break;
                        case "苏州市":
                            posdesc = "上有天堂，下有苏杭。";
                            break;
                        default:
                            posdesc = "散装是必须要散装的（doge）";
                            break;
                    }
                    break;
                case "浙江省":
                    posdesc = "东风渐绿西湖柳，雁已还人未南归。";
                    break;
                case "河南省":
                    switch (ipLoacation.result.ad_info.city) {
                        case "郑州市":
                            posdesc = "豫州之域，天地之中。";
                            break;
                        case "南阳市":
                            posdesc = "臣本布衣，躬耕于南阳。此南阳非彼南阳！";
                            break;
                        case "驻马店市":
                            posdesc = "峰峰有奇石，石石挟仙气。";
                            break;
                        case "开封市":
                            posdesc = "刚正不阿包青天。";
                            break;
                        case "洛阳市":
                            posdesc = "洛阳牡丹甲天下。";
                            break;
                        default:
                            posdesc = "可否带我品尝河南烩面啦？";
                            break;
                    }
                    break;
                case "安徽省":
                    posdesc = "蚌埠住了，芜湖起飞！";
                    break;
                case "福建省":
                    posdesc = "井邑白云间，岩城远带山。";
                    break;
                case "江西省":
                    posdesc = "落霞与孤鹜齐飞，秋水共长天一色。";
                    break;
                case "山东省":
                    posdesc = "遥望齐州九点烟，一泓海水杯中泻。";
                    break;
                case "湖北省":
                    switch (ipLoacation.result.ad_info.city) {
                        case "武汉市":
                            switch (ipLoacation.result.ad_info.district) {  // 细化到武汉各区
                                case "洪山区":
                                    posdesc = "珞珈山下书香浓，东湖岸边风光好~";  // 洪山区专属（武汉大学所在地）
                                    break;
                                case "武昌区":
                                    posdesc = "来碗热干面，逛个户部巷~";  // 武昌区地标
                                    break;
                                case "江汉区":
                                    posdesc = "江汉路步行街走一走~";  // 江汉区特色
                                    break;
                                case "江岸区":
                                    posdesc = "长江二桥下的夜景真美~";  // 江岸区地标
                                    break;
                                case "汉阳区":
                                    posdesc = "龟山电视塔下，看长江东流~";  // 汉阳区特色
                                    break;
                                default:
                                    posdesc = "来碗热干面~";  // 武汉其他区通用
                                    break;
                            }
                            break;
                        case "宜昌市":
                            posdesc = "三峡大坝的壮阔，一定要亲眼看看~";  // 宜昌地标
                            break;
                        case "襄阳市":
                            posdesc = "襄阳古城墙，见证千年风云~";  // 襄阳特色
                            break;
                        case "黄冈市":
                            posdesc = "红安将军县，辈出将才！";  // 黄冈红安县特色
                            break;
                        case "十堰市":
                            posdesc = "武当山的日出，值得早起~";  // 十堰地标
                            break;
                        default:
                            posdesc = "湖北的藕汤，暖心又暖胃~";  // 湖北省其他城市通用
                            break;
                    }
                    break;
                case "湖南省":
                    posdesc = "74751，长沙斯塔克。";
                    break;
                case "广东省":
                    posdesc = "老板来两斤福建人。";
                    break;
                case "广西壮族自治区":
                    posdesc = "桂林山水甲天下。";
                    break;
                case "海南省":
                    posdesc = "朝观日出逐白浪，夕看云起收霞光。";
                    break;
                case "四川省":
                    posdesc = "请我吃火锅！（doge）";
                    break;
                case "贵州省":
                    posdesc = "茅台，学生，再塞200。";
                    break;
                case "云南省":
                    posdesc = "玉龙飞舞云缠绕，万仞冰川直耸天。";
                    break;
                case "西藏自治区":
                    posdesc = "躺在茫茫草原上，仰望蓝天。";
                    break;
                case "陕西省":
                    posdesc = "给我来份臊子面加馍！";
                    break;
                case "甘肃省":
                    posdesc = "羌笛何须怨杨柳，春风不度玉门关。";
                    break;
                case "青海省":
                    posdesc = "你们那的牛肉干和老酸奶肯定很好吃！";
                    break;
                case "宁夏回族自治区":
                    posdesc = "大漠孤烟直，长河落日圆。";
                    break;
                case "新疆维吾尔自治区":
                    posdesc = "驼铃古道丝绸路，胡马犹闻唐汉风。";
                    break;
                case "台湾省":
                    posdesc = "我在这头，大陆在那头。";
                    break;
                case "香港特别行政区":
                    posdesc = "永定贼有残留地鬼嚎，迎击光非岁玉。";
                    break;
                case "澳门特别行政区":
                    posdesc = "性感荷官，在线发牌。";
                    break;
                default:
                    posdesc = "带我去你的城市逛逛吧！";
                    break;
            }
            break;
        default:
            posdesc = "带我去你的国家逛逛吧。";
            break;
    }

    //根据本地时间切换欢迎语
    let timeChange;
    let date = new Date();
    if (date.getHours() >= 5 && date.getHours() < 11) timeChange = "<span>上午好🌤️</span>，一日之计在于晨！";
    else if (date.getHours() >= 11 && date.getHours() < 13) timeChange = "<span>中午好☀️</span>，该摸鱼吃午饭了。";
    else if (date.getHours() >= 13 && date.getHours() < 15) timeChange = "<span>下午好🕞</span>，懒懒地睡个午觉吧！";
    else if (date.getHours() >= 15 && date.getHours() < 16) timeChange = "<span>三点几啦</span>，一起饮茶呀！";
    else if (date.getHours() >= 16 && date.getHours() < 19) timeChange = "<span>夕阳无限好🌇！</span>";
    else if (date.getHours() >= 19 && date.getHours() < 24) timeChange = "<span>晚上好</span>，夜生活嗨起来！";
    else timeChange = "夜深了🌙，早点休息，少熬夜。";

    try {
        //自定义文本和需要放的位置
        document.getElementById("welcome-info").innerHTML = `<div style="text-align: center; line-height: 1.6; font-weight: 400;">
  欢迎来自 <b style="color: var(--theme-color);">${pos}</b> 的小友💖<br>
  你当前距博主约 <b style="color: var(--theme-color);">${dist}</b> 公里！<br>
  <div style="text-align: center;">你的IP地址：</div>
  <b class="ip-address" style="color: var(--theme-color); font-weight: 700;">${ip}</b><br>
  ${timeChange}<br>
  Tip：<b style="color: var(--theme-color);">${posdesc}🍂</b>
</div>`;
    } catch (err) {
        // console.log("Pjax无法获取#welcome-info元素🙄🙄🙄")
    }
}
window.onload = showWelcome;
// 如果使用了pjax在加上下面这行代码
document.addEventListener('pjax:complete', showWelcome);

2.在主题配置中引入 JS

打开博客根目录的_config.butterfly.yml（主题配置文件），找到inject.bottom

，添加以下内容（引入 jQuery 和我们的txmap.js）：

1
2
3
4
inject: 
  bottom: 
    <script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
    - <script async data-pjax src="/js/txmap.js"></script> # 引入我们写的定位逻辑

三、调整组件显示位置

这一步是指定 “欢迎信息要显示在页面哪个位置”，比如公告栏下方、作者卡片下方等。

以 “显示在公告栏下方” 为例：

image-20251104211925489

  • 找到主题的 themes/butterfly/layout/includes/widget/card_announcement.pug 文件；
  • 在文件最后一行，添加 #welcome-info（和上一行缩进一致），保存即可。

如果想显示在其他位置（比如作者卡片下方），就打开对应的card_author.pug文件，同样在最后添加#welcome-info。

四、个性化 CSS 样式（调整外观）

这一步是让 “欢迎信息组件” 的样式和你的博客主题更搭配，比如改背景色、圆角等。

  1. 新建并编写custom.css

    在博客根目录的 source/css/ 文件夹下（没有css文件夹就新建），新建custom.css，复制以下代码，可根据喜好修改：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    /* 在source/css/custom.css中添加 */
    #welcome-info {
      background-color: #f8f9fa !important; 
      border-radius: 8px;
      padding: 12px;
      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.05);
      font-family: "Noto Sans SC", sans-serif; /* 可选：引入清晰的无衬线字体 */
    }

    #welcome-info b, #welcome-info strong {
      color: #0d6efd !important;
      font-weight: 600 !important; /* 加粗字体，与右侧一致 */
    }

    #welcome-info .ip-address {
      color: #0d6efd !important;
      font-family: monospace;
      font-weight: 700 !important; /* IP地址也加粗 */
    }


  2. 在主题配置中引入 CSS

    打开 _config.butterfly.yml，找到inject.head，添加以下内容：

    1
    2
    3
    inject: 
      head: 
        - <link rel="stylesheet" href="/css/custom.css">

五、验证效果

  • 执行 hexo clean && hexo s，在localhost:4000预览；
  • 打开页面后，能看到 “欢迎信息” 组件显示访客地区、距离、IP 和个性化问候语；
  • 也可以去腾讯定位工具的 “应用详情” 里，看 “IP 定位” 的调用次数是否增加，增加则说明配置成功。

image-20251104212011083