跳转至正文
@capgo/capacitor-nativegeocoder 已重命名 已从 @capgo/nativegeocoder 重命名为 @capgo/capacitor-nativegeocoder. 位置 开源

原生地理编码器 Capacitor 插件

使用原生地理编码实现地址与坐标之间的相互转换

安装

bun add @capgo/capacitor-nativegeocoder bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-nativegeocoder
  • pnpm add @capgo/capacitor-nativegeocoder
  • yarn add @capgo/capacitor-nativegeocoder

指南

如何在 Capacitor 中使用 Native Geocoder

在设备上测试

下载 Capgo App,然后扫描二维码 code。

Native Geocoder 插件预览二维码 code

使用 @capgo/capacitor-nativegeocoder

用于原生正向和反向地理编码的 Capacitor 插件。

安装

npm install @capgo/capacitor-nativegeocoder
npx cap sync

插件暴露的内容

  • reverseGeocode - 将经纬度转换为地址。
  • forwardGeocode - 将地址转换为经纬度。

用法示例

reverseGeocode

将经纬度转换为地址。

import { NativeGeocoder } from '@capgo/capacitor-nativegeocoder';

const result = await NativeGeocoder.reverseGeocode({
  latitude: 48.8566,
  longitude: 2.3522,
});
console.log(result);

forwardGeocode

将地址转换为经纬度。

import { NativeGeocoder } from '@capgo/capacitor-nativegeocoder';

const result = await NativeGeocoder.forwardGeocode({ addressString: 'address-string' });
console.log(result);

完整参考

从“使用 @capgo/capacitor-nativegeocoder”继续

如果你正在使用 使用 @capgo/capacitor-nativegeocoder 要规划原生插件工作,请将其与 @capgo/capacitor-nativegeocoder 关于 @capgo/capacitor-nativegeocoder 中的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节,以及 添加或更新插件 有关添加或更新插件的实现细节。

常见问题

Native Geocoder 插件常见问题

如何在 Capacitor 应用中安装 Native Geocoder 插件?

运行“bun add @capgo/capacitor-nativegeocoder”(或“npm install @capgo/capacitor-nativegeocoder”),然后运行“bunx cap sync”,让 iOS 和 Android 项目加载到原生 code。在应用 code 中从“@capgo/capacitor-nativegeocoder”导入即可。

@capgo/capacitor-nativegeocoder 是否支持 React、Vue 和 Angular?

是的。Native Geocoder 是一个 Capacitor package,因此它能与任何运行在 Capacitor 中的 Web framework 配合使用,包括 Ionic、React、Vue、Angular、Svelte 和纯 JavaScript。

@capgo/capacitor-nativegeocoder 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-nativegeocoder 是免费开源的吗?

是的。code 已在 GitHub 上公开,地址为 https://github.com/Cap-go/capacitor-nativegeocoder/,并且可从 npm 免费安装该 package。欢迎提交 bug 报告和 pull request。

我可以在不经过 App Store 审核的情况下,更新使用了 Native Geocoder 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待应用审核,即可发布 Native Geocoder 更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo