MapTiler地理编码SDK导入问题求助：替代Mapbox实现正向地理编码

1. 确认依赖安装 #

确保你已经正确安装了MapTiler的官方客户端包：

npm install @maptiler/client

2. CommonJS 正确导入与配置 #

如果你习惯使用require，直接按以下方式导入并配置API密钥（密钥从MapTiler控制台获取，免费账号无需信用卡即可使用基础额度）：

const maptilerClient = require('@maptiler/client');

// 配置你的MapTiler API密钥
maptilerClient.config.apiKey = 'YOUR_MAPTILER_API_KEY';

3. 完整地理编码实现示例 #

下面是一个可直接运行的异步函数，接收地址参数后返回对应经纬度：

async function getCoordinatesFromAddress(address) {
  try {
    // 发起正向地理编码请求，只返回最匹配的1条结果
    const geocodeResult = await maptilerClient.geocoding.forward(address, {
      limit: 1
    });

    // 从返回结果中提取经纬度（注意MapTiler返回的是[经度, 纬度]）
    const [longitude, latitude] = geocodeResult.features[0].geometry.coordinates;
    
    console.log(`地址: ${address}`);
    console.log(`经纬度: 经度 ${longitude}, 纬度 ${latitude}`);
    return { longitude, latitude };
  } catch (err) {
    console.error('地理编码请求失败:', err.message);
    throw err;
  }
}

// 测试调用
getCoordinatesFromAddress('上海市黄浦区南京东路');

4. 解决导入常见问题 #

如果遇到导入报错，检查以下两点：

• 查看项目根目录的package.json，如果存在"type": "module"字段，要么删除该字段，要么将其改为"type": "commonjs"（这会强制Node.js使用CommonJS模块规范）。
• 确认@maptiler/client包已正确安装，可通过查看node_modules目录或重新执行安装命令验证。

5. 注意事项 #

• 免费MapTiler账号有每月的请求额度限制，足够新手开发测试使用。
• 如果地址匹配结果不理想，可以调整请求参数（比如增加limit数量，或者指定country参数缩小范围）。

内容的提问来源于stack exchange，提问作者Dipesh