Monkeybread Software - MBS FileMaker Plugin: CLGeocoder.ReverseGeocodeLocation

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: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

CLGeocoder.ReverseGeocodeLocation

Submits a reverse-geocoding request for the specified location.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
CLGeocoder	4.1	Yes	No	No	Yes, macOS only	Yes

MBS( "CLGeocoder.ReverseGeocodeLocation"; latitude; longitude { ; wait } ) More

Parameters

Parameter Description Example Flags

latitude The latitude of the coordinate.

longitude The longitude of the coordinate.

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

Parameter	Description	Example	Flags
latitude	The latitude of the coordinate.
longitude	The longitude of the coordinate.
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

Result

Returns reference number or error.

Description

Submits a reverse-geocoding request for the specified location.
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 reverse-geocoding request, do not attempt to initiate another reverse- or forward-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.
CoreLocation Geocoder reference numbers are starting at 24000 and counting up for each new geocoder.

Examples

Reverse geocode location:

MBS("CLGeocoder.ReverseGeocodeLocation"; CLGeocoder::Latitude; CLGeocoder::Longitude)

Run query and get back JSON or error:

Let ( [
latitude = 52.517631899999998;
longitude = 13.4096574;
// run query and wait a bit
g = MBS( "CLGeocoder.ReverseGeocodeLocation"; latitude; longitude; 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 )

Example Databases

Blog Entries

Release notes

Version 10.1
- Added wait parameter for CLGeocoder.GeocodeAddressString or CLGeocoder.ReverseGeocodeLocation function.

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

CLGeocoder.PlacemarkValue - CLibrary.Load

Feedback: Report problem or ask question.