新手求助:如何使用Curl向Wrld3D API提交室内地图POST请求
如何正确执行Wrld3D室内地图提交的Curl POST请求
别担心,完全不懂Curl也没关系,我一步步带你完成这个室内地图的提交操作:
1. 先确认你的设备上有Curl
首先得确保你能用到Curl工具:
- Windows用户:Win10及以上系统一般自带Curl。按下Win+R,输入
cmd打开命令提示符,然后敲入curl --version,如果能看到版本信息就说明没问题;如果没有,去Curl官方下载安装包,一路默认安装即可。 - macOS/Linux用户:打开终端,输入
curl --version,绝大多数系统自带这个工具。如果没有的话,macOS可以用brew install curl,Linux用sudo apt install curl(Debian/Ubuntu系)或者对应的包管理器命令安装。
2. 准备并替换所有必填参数
把官方给的命令里的占位符全部换成你的真实信息,别漏了哦:
dev_auth_token:替换成你从Wrld3D获取的开发令牌(这是官方给你的专属验证信息,千万别填错)"my venue name":换成你的场馆真实名称,比如"Downtown Coffee Shop"<address>:场馆的实际街道地址,比如"456 Oak Ave, Chicago, IL"<phone no.>:场馆的联系电话,比如"+1987654321"<email address>:场馆的官方联系邮箱,比如"contact@coffeeshop.com"<email address for notifications>:你用来接收提交进度通知的邮箱,比如"yourname@example.com"- 另外你提到命令里的
-F ve...应该是没写完的部分,大概率是需要上传地图文件的参数,比如-F venue_file=@/path/to/your/map.pdf,把/path/to/your/map.pdf换成你本地地图文件的实际路径(比如Windows下可能是C:\Users\You\Documents\floorplan.png)
3. 完整的命令示例
修改后的命令大概是这样的(把所有占位符换成你的信息):
curl -v -XPOST https://indoor-maps-api.wrld3d.com/v1/edits/?token=your_real_dev_token -F name="Downtown Coffee Shop" -F venue_street_address="456 Oak Ave, Chicago, IL" -F venue_phone_number="+1987654321" -F venue_email="contact@coffeeshop.com" -F submission_contact_email="yourname@example.com" -F venue_file=@C:\Users\You\Documents\coffee_shop_floorplan.png
简单解释下关键部分:
-v:会显示详细的请求日志,方便你排查提交时的问题-XPOST:明确告诉Curl这是一个POST类型的请求- 每个
-F后面跟着一个表单字段,对应提交的一项信息
4. 执行命令
- Windows:打开命令提示符或PowerShell,把修改好的命令粘贴进去,按下回车就行
- macOS/Linux:打开终端,粘贴命令后按回车
5. 查看提交结果
- 如果提交成功,你会收到JSON格式的响应信息,提示提交完成
- 如果出现错误(比如令牌无效、参数缺失),
-v参数会显示详细的错误提示,你可以根据提示调整参数后重新尝试
内容的提问来源于stack exchange,提问作者Ahmed Wael
相关产品推荐
相关产品推荐

