2.1.1 • Published 4 years ago

nativescript-google-places-sdk v2.1.1

Weekly downloads
12
License
MIT
Repository
github
Last release
4 years ago

NativesScript Google Place SDK

A NativesScript plugin for Google Places SDK.

Documentation:

Requirements

Enable Google Places API if you have not already done so.

Configure skip library check in tsconfig.json

{
  "compilerOptions": {
    ...
    "skipLibCheck": true
    ...
  }
}

Installation

tns plugin add nativescript-google-place-sdk

Usage

NativeScript

Initialize the Place SDK

app.ts

...
Place.initialize(isAndroid ? 'GOOGLE_PLACE_ANDROID_API_KEY' : 'GOOGLE_PLACE_IOS_API_KEY');
...

Show the Autocomplete UI

my-awesome-page.xml

<Button text="Search" tap="search()"></Button>

my-awesome-page.ts

export function search(): void {
    PlaceAutocomplete.show()
    .then(
        (result) => {
            if (result) {
                console.log('Place Details:', result);
            }
        },
        (err) => console.error(err)
    );
}

NativeScript + Angular

Initialize the Place SDK

app.component.ts

@Component({
    moduleId: module.id,
    selector: 'ns-app',
    templateUrl: 'app.component.html'
})
export class AppComponent implements OnInit {
    ngOnInit(): void {
        Place.initialize(isAndroid ? 'GOOGLE_PLACE_ANDROID_API_KEY' : 'GOOGLE_PLACE_IOS_API_KEY');
    }
}

Show the Autocomplete UI

my-awesome.component.html

<Button [text]="Search" (tap)="search()"></Button>

my-awesome.component.ts

@Component({
    moduleId: module.id,
    selector: 'ns-awesome',
    templateUrl: 'my-awesome.component.html'
})
export class MyAwesomeComponent {
    search(): void {
        PlaceAutocomplete.show()
        .then(
            (result) => {
                if (result) {
                    console.log('Place Details:', result);
                }
            },
            (err) => console.error(err)
        );
    }
}

API

Place

initialize(apiKey)

PropertyDefaultDescription
apiKeyundefinedGoogle Place API key

Example

Place.initialize('GOOGLE_PLACE_API_KEY');

Autocomplete

show(options)

PropertyDefaultDescription
fieldsundefinedDefine the types of field to retrieve. By default will retrieve all types.
iosundefinediOS related options
ios.appearanceundefinediOS appearance options. See documentation for more info.
ios.appearance.primaryTextColorundefinedPrimary text color
ios.appearance.primaryTextHighlightColorundefinedPrimary text highlight color
ios.appearance.secondaryTextColorundefinedSecondary text color
ios.appearance.tableCellBackgroundColorundefinedTable cell background color
ios.appearance.tableCellSeparatorColorundefinedTable cell separator color
ios.appearance.tintColorundefinedTint color
locationBias.southwestundefinedSouthwest bound
locationBias.northeastundefinedNortheast bound
FieldData TypeDescription
addressstringAddress
idstringId
lat_lngobjectCoordinates
namestringPlace name
phone_numberstringPhone number
price_levelnumberPricing
ratingnumberRating
user_ratings_totalnumberTotal ratings
utc_offset_minutesnumberUTC offset in minutes
viewportobjectViewport
website_uristringURL

Example

PlaceAutocomplete.show({ fields: ['name'] })
.then(
    (result) => {
        if (result) {
            console.log('Place Details:', result);
        }
    },
    (err) => console.error(err)
);

License

MIT

2.1.1

4 years ago

2.1.0

4 years ago

2.0.0

4 years ago

1.0.0

5 years ago