npm 包 google-places-autocomplete-service 使用教程

阅读时长 7 分钟读完

在前端开发过程中,我们经常会用到一些地理位置相关的功能。比如,用户输入地址时,需要实现自动提示和自动匹配等功能。在这种情况下,Google Maps API 是一个常用的选择。然而,Google Maps API 对于小项目来说可能有一些过度应用的疑虑。因此,如果您只是需要实现一个简单的地址自动完成器,那么 npm 包 google-places-autocomplete-service 将会非常适合您。本文将为您详细介绍该包的使用方法,包括安装、初始化、API 等内容。

安装

首先,您需要先安装该包。您可以通过npm 安装:

或者通过 yarn 安装:

初始化

在使用该 npm 包时,您首先需要在 HTML 文件中添加一些代码。例如,以下代码会添加一个包含自动完成器的输入框:

接下来,在您的 JavaScript 文件中初始化 google-places-autocomplete-service。您可以引用 google-places-autocomplete-service 包中的 AutocompleteService 类。然后,可以使用创建的对象来调用 autocomplete() 方法。例如,以下代码将在用户输入地址的同时实现提示和自动匹配功能:

上述代码中,inputElement 就是包含自动完成器的文本框。其中,预测结果作为一个数组传递给回调函数。

API

google-places-autocomplete-service 中的 AutocompleteService 类只提供一个 autocomplete() 方法。下面是该方法的主要参数:

  • input: 包含自动完成器的文本框的元素。
  • callback: 以预测结果为参数的回调函数。

除此之外,该方法还可以使用一些其他选项。例如,您可以使用 types 参数重写结果的类型。例如,以下代码只返回结果为“地址”,“地点”和“街道地址”的预测:

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

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

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

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

示例代码

以下是一些完整的示例代码,其中第一个示例展示了如何在文本输入框中启用自动完成器。第二个示例演示了如何在 Google 地图上自动补全地址。

自动提示示例:

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

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

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

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

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

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

自动完成地址示例:

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

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

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

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

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

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

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

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

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

总结

本文详细介绍了 google-places-autocomplete-service 的使用方法,基本覆盖了其主要的安装、初始化、API 和示例等内容。可以看出,google-places-autocomplete-service 是一个相对较小但功能强大的 npm 包,可以实现一些常用的地理位置相关功能。希望本文对您有所帮助,为您的项目提供一些有价值的参考。

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

纠错
反馈