Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.5   11.0   11.1   11.2   11.3   11.4   11.5   12.0   12.1   12.2    Statistic    FMM    Blog  


Submits a forward-geocoding request using the specified string.

Component Version macOS Windows Linux Server iOS SDK License
CLGeocoder 4.1 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes Paid
MBS( "CLGeocoder.GeocodeAddressString"; Address { ; wait } )   More


Parameter Description Example Flags
Address A string describing the location you want to look up. For example, you could specify the string "1 Infinite Loop, Cupertino, CA"” to locate Apple headquarters. "Andernach, Germany"
wait Available in MBS FileMaker Plugin 10.1 or newer.
Pass 1 to wait for geocoder to have a result.
Pass 0 to not wait and check later if geocoder is done.
1 Optional


Returns reference number or error.


Submits a forward-geocoding request using the specified string.
This method submits the specified location data to the geocoding server asynchronously and returns. Your completion handler block will be executed on the main thread. After initiating a forward-geocoding request, do not attempt to initiate another forward- or reverse-geocoding request.
Geocoding requests are rate-limited for each app, so making too many requests in a short period of time may cause some of the requests to fail. When the maximum rate is exceeded, the geocoder passes an error back.
You need to use CLGeocoder.Close later to free the geocoder.


Geocodes an address:

$r = MBS("CLGeocoder.GeocodeAddressString"; CLGeocoder::AddressString)

Query in one let statement and return JSON or error:

Let ( [
    Address = "Berlin, Germany";
    // run query and wait a bit
    g = MBS( "CLGeocoder.GeocodeAddressString"; Address; 1 );
    e = MBS("IsError");
    // query JSON if we got something
    r = If (e = 0; MBS( "CLGeocoder.JSON"; g ); g);
    // free resources
    f = If (e = 0; MBS( "CLGeocoder.Close"; g ); 0)
]; r )

See also

Release notes

Example Databases

Blog Entries

Created 18th August 2014, last changed 12nd February 2020

CLGeocoder.ErrorMessage - CLGeocoder.JSON

Feedback: Report problem or ask question.

Start Chat