用 Twilio/SendGrid 为 IoT 地理围栏触发函数添加短信与邮件通知
用 Twilio/SendGrid 为 IoT 地理围栏触发函数添加短信与邮件通知【免费下载链接】IoT-For-Beginners12 Weeks, 24 Lessons, IoT for All!项目地址: https://gitcode.com/GitHub_Trending/io/IoT-For-Beginners本文围绕 IoT-For-Beginners 运输项目第 4 课Geofences的课后作业展开。该作业要求在已有的 Azure Functions 地理围栏触发器中通过 Azure Functions 输出绑定接入 Twilio SMS 或 SendGrid 邮件服务在 GPS 坐标进入或离开地理围栏时发送实时通知并保证只在进入或只在离开时触发一次。读完本文你将掌握 Azure Functions 输出绑定Output Binding的配置方法、Python 函数中func.Out参数的使用方式以及如何在无状态 Serverless 代码中实现进入/离开二选一的通知逻辑。任务背景当前代码只记录距离不发送通知在完成第 4 课主体内容后你的gps-trigger函数应用里已经有两个事件触发器iot-hub-trigger负责把 IoT Hub 收到的 GPS 遥测数据写入 Blob 存储geofence-trigger通过独立的geofence消费组读取同一批事件调用 Azure Maps Geofence API 判断坐标与地理围栏的距离并仅把结果写入日志。仓库中现成的实现位于 geofence-trigger/init.pydef main(events: List[func.EventHubEvent]): maps_key os.environ[MAPS_KEY] geofence_udid os.environ[GEOFENCE_UDID] for event in events: event_body json.loads(event.get_body().decode(utf-8)) lat event_body[gps][lat] lon event_body[gps][lon] url https://atlas.microsoft.com/spatial/geofence/json params { api-version: 1.0, deviceId: gps-sensor, subscription-key: maps_key, udid : geofence_udid, lat : lat, lon : lon } response requests.get(url, paramsparams) response_body json.loads(response.text) distance response_body[geometries][0][distance] if distance 999: logging.info(Point is outside geofence) elif distance 0: logging.info(fPoint is just outside geofence by a distance of {distance}m) elif distance -999: logging.info(fPoint is inside geofence) else: logging.info(fPoint is just inside geofence by a distance of {distance}m)可以看到函数结尾只有logging.info。本作业的交付目标就是把这段仅记录的代码升级为会通知的代码当坐标进入或离开围栏时通过短信或邮件把结果推送出去。配套的触发绑定配置位于 geofence-trigger/function.json它通过eventHubTrigger接入geofence消费组{ scriptFile: __init__.py, bindings: [ { type: eventHubTrigger, name: events, direction: in, eventHubName: samples-workitems, connection: IOT_HUB_CONNECTION_STRING, cardinality: many, consumerGroup: geofence, dataType: binary } ] }理解距离语义通知条件从何而来设计通知逻辑之前必须先理解 Azure Maps Geofence API 返回的distance字段的四种取值详见 README.md 与仓库图片 search-buffer-and-distance.png取值含义999点位于围栏外且超出搜索缓冲区默认 50m 0小于缓冲区点位于围栏外距离围栏边缘若干米-999点位于围栏内且深入围栏超过搜索缓冲区 0大于 -缓冲区点位于围栏内距离围栏边缘若干米简言之负数代表在围栏内正数代表在围栏外绝对值小于缓冲区时给出精确距离米否则以 999/-999 表示远在缓冲区之外。searchBuffer默认 50m可通过参数在 0~500m 范围内调整用于抵消 GPS 本身的定位误差。这一语义正是进入/离开判断的直接依据distance 0视为进入insidedistance 0视为离开outside。Azure Functions 绑定机制无需写 HTTP 客户端代码Azure Functions 的**绑定Bindings**机制允许函数以声明方式接入外部服务触发器Trigger负责函数何时执行输入/输出绑定Input/Output Bindings负责数据如何进出。你只需要在function.json中声明绑定运行时就会自动完成与服务端的连接、鉴权和序列化函数体内部只需读写绑定参数即可。Twilio 与 SendGrid 都是 Azure Functions 官方支持的第三方绑定Twilio SMS 绑定twilioSms输出绑定向指定手机号发送文本短信SendGrid 绑定sendGrid输出绑定发送 HTML/纯文本邮件。提示本作业原文明确要求先阅读 Microsoft 官方文档《Twilio binding for Azure Functions》与《Azure Functions SendGrid bindings》以 Python 标签页为准再动手配置以保证绑定字段与当前运行时版本匹配。下文给出的是与 Azure Functions Python 运行时一致的绑定结构与代码写法。前置准备注册与获取凭据在修改任何代码之前需要准备两项服务的凭据Twilio短信方案到 Twilio 官网注册免费账号在控制台获取Account SID与Auth Token开通一个带号码的试用号码Trial Number该号码将作为短信发送方from验证你的接收手机号试用账号只能向已验证号码发送。SendGrid邮件方案到 SendGrid 官网注册账号生成API Key权限至少包含 Mail Send在 Azure 中创建一个 SendGrid 资源或直接使用 SendGrid 站点生成的 API Key。方案一Twilio SMS 输出绑定1. 修改 function.json添加 twilioSms 输出绑定在 geofence-trigger/function.json 的bindings数组中追加一个输出绑定{ type: twilioSms, name: message, accountSidSetting: TwilioAccountSid, authTokenSetting: TwilioAuthToken, from: 15551234567, direction: out }字段说明字段说明type固定为twilioSms声明这是一个 Twilio 短信输出绑定name绑定在 Python 函数中对应的参数名这里为messageaccountSidSetting存放 Account SID 的应用设置键名实际值写在local.settings.json/ Application Settings 中authTokenSetting存放 Auth Token 的应用设置键名from发送方号码即 Twilio 分配的号码格式1xxxxxxxxxxdirection固定为out表示输出方向2. 在 local.settings.json 中添加凭据仓库中的 local.settings.json 已预留了MAPS_KEY与GEOFENCE_UDID两个键位。在此基础上补充 Twilio 的 SID 与 Token键名必须与accountSidSetting、authTokenSetting指向的键名完全一致{ IsEncrypted: false, Values: { FUNCTIONS_WORKER_RUNTIME: python, AzureWebJobsStorage: UseDevelopmentStoragetrue, IOT_HUB_CONNECTION_STRING: connection string, STORAGE_CONNECTION_STRING: connection string, MAPS_KEY: subscription key, GEOFENCE_UDID : UDID, TwilioAccountSid: your account sid, TwilioAuthToken: your auth token } }3. 修改init.py发送短信修改main函数签名以接收输出绑定参数并在进入围栏时发送短信from typing import List import logging import azure.functions as func import json import os import requests def main(events: List[func.EventHubEvent], message: func.Out[str]): maps_key os.environ[MAPS_KEY] geofence_udid os.environ[GEOFENCE_UDID] for event in events: event_body json.loads(event.get_body().decode(utf-8)) lat event_body[gps][lat] lon event_body[gps][lon] url https://atlas.microsoft.com/spatial/geofence/json params { api-version: 1.0, deviceId: gps-sensor, subscription-key: maps_key, udid : geofence_udid, lat : lat, lon : lon } response requests.get(url, paramsparams) response_body json.loads(response.text) distance response_body[geometries][0][distance] # 进入围栏distance 为负时发送一次短信通知 if distance 0: message.set( fYour GPS sensor has entered the geofence! fLocation: {lat},{lon} ) logging.info(Sending SMS: point is inside geofence)关键点func.Out[str]Python 运行时把输出绑定作为参数注入调用message.set(...)即触发发送通知内容set()接收的字符串会作为短信正文发送只发一次本作业要求进入或离开——但不能两者都发。上面示例只处理distance 0进入分支离开分支保持原日志输出。若想改为只在离开时通知则只保留distance 0分支即可。4. 实现进入/离开二选一的注意点Azure Functions 触发器是有状态重放机制IoT Hub 允许从消费组重放未处理事件参见 README 中关于消费组的说明。如果函数在进入与离开两个分支都调用message.set()那么卡车在地理围栏边界反复横穿时就会产生大量冗余短信。正确做法是只保留一个方向的通知分支作业评分也以此为准成功做到只在进入或只在离开时收到通知为优秀更严格的工程做法是记录上一次状态例如写入 Blob 或使用持久化状态仅在状态发生翻转时发送通知——这属于生产级增强作业不强制要求。方案二SendGrid 邮件输出绑定如果选择邮件通知则在function.json中添加sendGrid输出绑定{ type: sendGrid, name: message, apiKey: SendGridApiKey, from: senderexample.com, to: recipientexample.com, subject: Geofence alert, direction: out }字段说明字段说明type固定为sendGridnamePython 函数中的绑定参数名apiKey存放 SendGrid API Key 的应用设置键名from发件人邮箱to收件人邮箱subject邮件主题direction固定为out在local.settings.json的Values中补充SendGridApiKey: your sendgrid api keyPython 代码中除使用func.Out[str]并message.set(...)发送纯文本外也可以set()一个字典来自定义收件人、主题与正文message.set({ personalizations: [{ to: [{email: recipientexample.com}] }], subject: Geofence alert, content: [{ type: text/plain, value: fYour GPS sensor has entered the geofence! Location: {lat},{lon} }] })两种方案二选一即可满足作业要求不必同时实现。本地运行与云端部署本地验证启动 Functions 运行时让虚拟 IoT 设备或真实 GPS 传感器发送坐标。确认当坐标在围栏内且满足通知条件时收到短信/邮件当坐标在围栏外时不会收到通知或反之取决于你选择的方向日志中能看到geofence-trigger处理事件的输出。避免重复数据本地运行时若云端 Functions 仍在运行两个实例会通过同一消费组重复消费事件。可先停掉云端函数应用完成验证后再启动az functionapp stop --resource-group gps-sensor --name functions_app_name az functionapp start --resource-group gps-sensor --name functions_app_name部署云端将修改后的代码部署到 Azure Functions 应用同时务必同步上传新增的 Application SettingsTwilioAccountSid、TwilioAuthToken或SendGridApiKey。本地local.settings.json中的值不会被自动部署到云端这一点最容易遗漏。验收标准Rubric作业原文给出的评分表即本文实现的验收清单标准优秀合格待改进配置 Functions 绑定并收到邮件或短信成功配置绑定并仅在坐标进入或离开围栏时收到通知二选一能配置绑定但无法发送邮件/SMS或进入与离开两种状态都触发了通知未能配置绑定也未收到任何邮件/SMS对照此表自查时重点核对两点绑定是否真正生效而不是仅仅写好配置但没发出去以及通知是否只在单一方向触发。小结与延伸本作业的核心收获有三层绑定声明式接入通过function.json中的twilioSms/sendGrid输出绑定无代码接入第三方通信服务凭据统一托管在应用设置中状态判断与去重基于 Azure Maps Geofence API 的distance正负语义仓库中 geofence-trigger/init.py 已演示四种取值的分支处理实现进入或离开二选一的通知策略本地与云端的配置一致性新增绑定键名必须同时出现在本地local.settings.json与云端 Application Settings 中。想继续深入可以扩展实现多地理围栏支持Azure Maps 允许在同一 GeoJSONFeatureCollection中通过多个Feature各带唯一geometryId上传多个多边形参考 README.md 的挑战任务再让通知逻辑根据geometries数组找出最近或命中的那个围栏进行推送。完整参考代码位于仓库 3-transport/lessons/4-geofences/code/functions 目录原始作业说明见 assignment.md。【免费下载链接】IoT-For-Beginners12 Weeks, 24 Lessons, IoT for All!项目地址: https://gitcode.com/GitHub_Trending/io/IoT-For-Beginners创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

gpui-base Sheet 原语详解:从边缘进入的模态表面、焦点陷阱与关闭流程

gpui-base Sheet 原语详解:从边缘进入的模态表面、焦点陷阱与关闭流程

gpui-base Sheet 原语详解:从边缘进入的模态表面、焦点陷阱与关闭流程 【免费下载链接】gpui-kit Rust GUI components for building fantastic cross-platform desktop application by using GPUI. 项目地址: https://gitcode.com/GitHub_Trending/gp/gpui-kit …

2026/11/22 15:10:32 阅读更多 →
Gymnasium 向量环境工具函数完全指南:Space 批处理、共享内存与进程通信

Gymnasium 向量环境工具函数完全指南:Space 批处理、共享内存与进程通信

Gymnasium 向量环境工具函数完全指南:Space 批处理、共享内存与进程通信 【免费下载链接】Gymnasium A standard API for single-agent reinforcement learning environments, with popular reference environments and related utilities (formerly Gym) 项目地址…

2026/11/15 18:59:00 阅读更多 →
深入解析 Cilium 仓库中的 xxhash 包:Go 语言实现 XXH64 的原理、汇编加速与 zstd 实战应用

深入解析 Cilium 仓库中的 xxhash 包:Go 语言实现 XXH64 的原理、汇编加速与 zstd 实战应用

深入解析 Cilium 仓库中的 xxhash 包:Go 语言实现 XXH64 的原理、汇编加速与 zstd 实战应用 【免费下载链接】cilium eBPF-based Networking, Security, and Observability 项目地址: https://gitcode.com/GitHub_Trending/ci/cilium xxhash 是一个 Go 语言实…

2026/11/8 5:21:04 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻