npm 包 @binpar/react-native-geocoder 使用教程

阅读时长 7 分钟读完

在移动端开发过程中,位置信息是非常重要的,因为很多应用需要根据用户的信息做出相应的操作。@binpar/react-native-geocoder 是一个 React Native 的第三方库,它提供了关于地理编码和反编码的功能,可以让开发者轻松地获取位置信息。

安装

首先,你需要使用 npm 或者 yarn 来安装 @binpar/react-native-geocoder,运行以下命令:

或者

接下来需要在您的项目中 link 该库的原生模块。

对于 React Native 0.60 以上版本:

对于 React Native 0.59 以下版本:

使用

1. 初始化

需要将模块导入到项目中,并在组件的 constructor 中进行初始化:

注意,初始化需要传递 Google 的 API Key,你需要到 Google 开发者控制台 中创建一个项目并启用 Maps SDK for AndroidMaps SDK for iOS 权限。

2. 地理编码

地理编码通常指将地址转化为经纬度。在 @binpar/react-native-geocoder 中,你可以通过以下接口实现地理编码:

-- -------------------- ---- -------
-----------------------------------
  ---- -- -
    ----- - ---- --- - - ----------------------------------
    ---------------- -----
  --
  ----- -- -
    --------------------
  --
--

此处,我们将地址字符串传递给了 from 函数,该函数将返回一个 Promise 对象。在 Promise 的成功回调中,我们可以获取到响应对象的 results 字段,其中包含了地理编码的结果。

3. 反地理编码

反地理编码通常指将经纬度转化为地址。在 @binpar/react-native-geocoder 中,你可以通过以下接口实现反地理编码:

-- -------------------- ---- -------
---------------------- ---------------
  ---- -- -
    ----- ---------------- - -----------------------------------
    ------------------------------
  --
  ----- -- -
    --------------------
  --
--

此处,我们将经纬度作为参数传递给了 from 函数,该函数也将返回一个 Promise 对象。在 Promise 的成功回调中,我们同样可以获取到响应对象的 results 字段,其中包含了反地理编码的结果。

4. 参数选项

在调用 Geocoder 的 fromto 函数时,你可以使用以下参数:

language

设置地理编码或反地理编码结果的语言,默认为 "en"。

-- -------------------- ---- -------
-----------------------------------------------------
  ---- -- -
    ----- - ---- --- - - ----------------------------------
    ---------------- -----
  --
  ----- -- -
    --------------------
  --
--

region

设置地理编码或反地理编码的区域,以 ISO 3166-1 代码表示。

-- -------------------- ---- -------
---------------------------------------------------
  ---- -- -
    ----- - ---- --- - - ----------------------------------
    ---------------- -----
  --
  ----- -- -
    --------------------
  --
--

bounds

设置一个矩形范围,限制地理编码或反地理编码的结果在此范围内。

-- -------------------- ---- -------
-----------------------------
  ---------------------------- ------------------ ----------------- ------------------
  ------
    ---- -- -
      ----- - ---- --- - - ----------------------------------
      ---------------- -----
    --
    ----- -- -
      --------------------
    --
  --

示例代码

-- -------------------- ---- -------
------ ------ - --------- - ---- --------
------ - ----- ---- - ---- ---------------
------ -------- ---- --------------------------------

------ ----- ------------ ------- --------- -
  ------------------ -
    -------------
    ------------------------------
  -

  ------------------- -
    ----------------------------
    ---------------------
  -

  ---------------------- -
    ---------------------- ---------------
      ---- -- -
        ----- ---------------- - -----------------------------------
        -------------------- ------------ ------------------
      --
      ----- -- -
        --------------------
      --
    --
  -

  --------------- -
    -----------------------------------
      ---- -- -
        ----- - ---- --- - - ----------------------------------
        ------------------------- ---- -----
      --
      ----- -- -
        --------------------
      --
    --
  -

  -------- -
    ------ -
      ----- -------- ----- -- --------------- --------- ----------- -------- ---
        ---------- ------- -- --- --- -------------
      -------
    --
  -
-

结论

@binpar/react-native-geocoder 是一个强大的地理编码和反地理编码的工具,它可以让你轻松地在 React Native 中获取位置信息。撰写这篇文章的目的是为了帮助 React Native 开发者快速上手和使用该库。在实际开发中,使用该库不仅可以提高开发效率,也可以增强应用的性能和用户体验。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60057aea81e8991b448eb6e3

纠错
反馈