Skip to main content
Query Google Maps with a text string and country code list to retrieve predicted place results.

Parameters

PropertyTypeRequiredDescription
queryCodeStringYesSearch text — supports full words, substrings, place names, addresses, and plus codes
countryCodeArray<String>YesList of up to 15 ccTLD two-character country codes to restrict results (e.g. ["IT", "DE"])
successFunctionNoCallback on success
failFunctionNoCallback on failure

Success Callback

PropertyTypeDescription
successBooleanQuery success status
resultCodeString0 success · 1000 invalid params · 1001 network error · 1002 internal error · 2000 Google service error
resultMessageStringHuman-readable status message
placesListArrayList of matching PlaceInfo objects

PlaceInfo Object

FieldDescription
fullTextComplete place description (primary + secondary text)
primaryTextMain name (e.g. "Eiffel Tower")
secondaryTextSupporting details (e.g. location or address)
distanceMetersStraight-line distance from origin
placeIdGoogle Maps place identifier
placeTypesAssociated place type classifications

Code Example

my.call('searchPlaceByFuzzyCode', {
  queryCode: 'Piazza Duomo',
  countryCode: ['IT'],
  success: (res) => {
    const places = res.placesList;
    // Display results to the user
  },
  fail: (error) => {
    my.alert({ content: 'error: ' + JSON.stringify(error) });
  }
});