@angular-magic/ngx-gp-autocomplete

中文文档
2.0.2发布于 2024/02/27MITTypeScriptES Module近 30 天下载 3.8万

This module is a wrapper for Google Places Autocomplete JS library

原始使用文档
文档目录4 节
  1. Installation
  2. npm
  3. Integration
  4. GitHub

ngx-gp-autocomplete

Ngx-Markdown Logo

Demo: https://ngx-gp-autocomplete.angularmagic.com

This module is a wrapper for Google Places Autocomplete js library. Initial code base was copied from this project ngx-google-places-autocomplete, this module applies some fixes and improvements. Like @types/google.maps and @googlemaps/js-api-loader

NPM

Installation

npm

npm install @angular-magic/ngx-gp-autocomplete
npm install @googlemaps/js-api-loader
npm install --save @types/google.maps

Integration

  • Import NgxGpAutocompleteModule into your application module
import { NgxGpAutocompleteModule } from "@angular-magic/ngx-gp-autocomplete";

@NgModule({
  imports: [
    NgxGpAutocompleteModule,
    BrowserModule,
    FormsModule,
    //...
  ],
  providers: [
    {
      provide: Loader,
      useValue: new Loader({
        apiKey: 'YOUR_API_KEY',
        libraries: ['places']
      })
    },
    //...
  ],
  //...
})
<input #placesRef="ngx-places" ngx-gp-autocomplete [options]='options' (onAddressChange)="handleAddressChange($event)"/>
  • Additionally you can reference directive in your component
export class Component {
  @ViewChild('ngxPlaces') placesRef: NgxGpAutocompleteDirective;

  public handleAddressChange(place: google.maps.places.PlaceResult) {
    // Do some stuff
  }
}

GitHub

Please feel free to declare issues or contribute: https://github.com/angular-magic/ngx-gp-autocomplete

版本与发布记录

@angular-magic/ngx-gp-autocomplete 共发布 8 个版本,首次发布于 2023/02/22;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.0.2latest2024/02/272 年前
2.0.12024/02/262 年前
2.0.02023/10/103 年前
1.0.42023/06/233 年前
1.0.32023/05/083 年前
1.0.22023/02/223 年前

关于 @angular-magic/ngx-gp-autocomplete 的常见问题

@angular-magic/ngx-gp-autocomplete 是什么?

This module is a wrapper for Google Places Autocomplete JS library

如何安装 @angular-magic/ngx-gp-autocomplete?

在项目目录运行 npm install @angular-magic/ngx-gp-autocomplete,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@angular/core(>= 2.0.0)、@googlemaps/js-api-loader(^1.15.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@angular-magic/ngx-gp-autocomplete 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@angular-magic/ngx-gp-autocomplete 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@angular-magic/ngx-gp-autocomplete 可以商用吗?

@angular-magic/ngx-gp-autocomplete 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@angular-magic/ngx-gp-autocomplete 的下载量有多少?

根据 npm 官方下载统计,@angular-magic/ngx-gp-autocomplete 在 2026/10/06 – 2026/11/04 这 30 天内被下载 38,146 次,日均约 1,272 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@angular-magic/ngx-gp-autocomplete 还在维护吗?

最新版本 2.0.2 发布于 2024/02/27(2 年前);至今共发布 8 个版本,其中过去 12 个月发布了 0 个;首次发布于 2023/02/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。