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.GeocodeAddressString
Submits a forward-geocoding request using the specified string.
| Component | Version | macOS | Windows | Linux | Server | FileMaker iOS SDK |
| CLGeocoder | 4.1 | Yes | No | No | Yes, macOS only | Yes |
Parameters
| 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 |
Result
Returns reference number or error.
Description
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.
Examples
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
Example Databases
- Mac and iOS/CoreLocation/Address Mapping
- Mac and iOS/CoreLocation/CLGeocoder
- Mac and iOS/MapKit/MapView BeeExample
Blog Entries
- New in the MBS FileMaker Plugin 10.1
- MBS FileMaker Plugin, version 10.1pr4
- Core Location Geocoder with JSON
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.ErrorMessage - CLGeocoder.JSON
Feedback: Report problem or ask question.
Links
MBS FileMaker blog
