cordova-plugin-googleplaces-autocomplete v1.0.2

Cordova GooglePlaces plugin (iOS only!)

This plugin provides autocomplete feature from GooglePlaces iOS SDK in your application.

Install

$ cordova plugin add cordova-plugin-googleplaces-autocomplete

Then set your Google Maps API keys into your config.xml (Android / iOS).

<widget ...>
  <preference name="GOOGLE_PLACES_IOS_API_KEY" value="(api key)" />
</widget>

API

getAutocompleteSuggestions(query, filters, success, failure);

Returns a list of place suggestions for a given search query.

Example:

window.plugin.google.places.getAutocompleteSuggestions(
  'Paris',
  { country: 'FR' },
  function onSuccess(suggestions) {
    console.log(suggestions);
  },
  function onError(err) {
    console.error(err);
  }
);

getPlaceDetails(placeID, success, failure)

Returns detailed information about a specific place.

Example:

window.plugin.google.places.getPlaceDetails(
  "<placeID>",
  function onSuccess(result) {
    console.log('Place details:', result);
  },
  function onError(err) {
    console.error('Error:', err);
  }
);

TypeScript interfaces

interface GooglePlacesAutocompletePlugin {
  getAutocompleteSuggestions: (
    query: string,
    filters?: { country: string },
    success?: (results: GooglePlacesAutocompleteSuggestion[]) => void,
    failure?: (error: any) => void
  ) => void;

  getPlaceDetails: (
    placeID: string,
    success?: (result: GooglePlacesAutocompleteLocation) => void,
    failure?: (error: any) => void
  ) => void;
}

interface GooglePlacesAutocompleteSuggestion {
  fullText: string;
  placeID: string;
  primaryText: string;
  secondaryText: string;
}

interface GooglePlacesAutocompleteLocation {
  adminArea: string;
  country: string;
  countryCode: string;
  extra: {
    address: {
      City: string;
      Country: string;
      CountryCode: string;
      FormattedAddressLines?: string[];
      Name: string;
      State: string;
      Street: string;
      SubAdministrativeArea: string;
      thoroughfare: string;
      ZIP: string;
    };
    description: string;
    identifier: string;
    name: string;
    radius: string;
  };
  locality: string;
  position: { lat: number, lng: number };
  postalCode: string;
  subAdminArea: string;
  thoroughfare: string;
}