Component: CLGeocoder 
----------------------

Functions for geo coordinate lookup.

You can lookup your clients addresses, store the coordinates and later find records close to a given address.

| Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|
| [4.1](newinversion41.md "First functions introduced with version 4.1.") / [10.1](newinversion101.md "Newest functions in version 10.1.") | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

  
| Item | Details |
|:--|:--|
| [CLGeocoder.Cancel](CLGeocoderCancel.md)   Cancels a pending geocoding request. | Mac/iOS   4.1 |
| [CLGeocoder.Cancelled](CLGeocoderCancelled.md)   Whether the request was cancelled. | Mac/iOS   4.1 |
| [CLGeocoder.Close](CLGeocoderClose.md)   Closes a request and frees memory. | Mac/iOS   4.1 |
| [CLGeocoder.Distance](CLGeocoderDistance.md)   Returns the distance (in meters) of the two locations. | Mac/iOS   6.1 |
| [CLGeocoder.Done](CLGeocoderDone.md)   Queries whether the request is finished. | Mac/iOS   4.1 |
| [CLGeocoder.Error](CLGeocoderError.md)   Checks if this request got an error. | Mac/iOS   4.1 |
| [CLGeocoder.ErrorMessage](CLGeocoderErrorMessage.md)   Queries the error message of the geo coder. | Mac/iOS   4.1 |
| [CLGeocoder.GeocodeAddressString](CLGeocoderGeocodeAddressString.md)   Submits a forward-geocoding request using the specified string. | Mac/iOS   4.1 |
| [CLGeocoder.JSON](CLGeocoderJSON.md)   Queries data of geo coder as JSON. | Mac/iOS   10.1 |
| [CLGeocoder.PlacemarkCount](CLGeocoderPlacemarkCount.md)   Queries the number of placemarks found. | Mac/iOS   4.1 |
| [CLGeocoder.PlacemarkValue](CLGeocoderPlacemarkValue.md)   Queries a value of the placemarks found. | Mac/iOS   4.1 |
| [CLGeocoder.ReverseGeocodeLocation](CLGeocoderReverseGeocodeLocation.md)   Submits a reverse-geocoding request for the specified location. | Mac/iOS   4.1 |

12 functions shown.

These functions require a license (50%).

### Release notes

- **Version 14.1**
    - Added timeout for [CLGeocoder.GeocodeAddressString](https://www.mbsplugins.eu/CLGeocoderGeocodeAddressString.shtml) and [CLGeocoder.ReverseGeocodeLocation](https://www.mbsplugins.eu/CLGeocoderReverseGeocodeLocation.shtml) functions.
- **Version 10.1**
    - Added [CLGeocoder.JSON](https://www.mbsplugins.eu/CLGeocoderJSON.shtml) to return JSON for a geo coder with all details.
    - Added wait parameter for [CLGeocoder.GeocodeAddressString](https://www.mbsplugins.eu/CLGeocoderGeocodeAddressString.shtml) or [CLGeocoder.ReverseGeocodeLocation](https://www.mbsplugins.eu/CLGeocoderReverseGeocodeLocation.shtml) function.
- **Version 9.0**
    - Improved out of bounds error message for [Menu.InsertItem](http://www.mbsplugins.eu/MenuInsertItem.shtml), [Menu.RemoveItemAtIndex](http://www.mbsplugins.eu/MenuRemoveItemAtIndex.shtml), [Calendar.Item.GetAttendeeURL](http://www.mbsplugins.eu/CalendarItemGetAttendeeURL.shtml), [Calendar.Item.GetAttendeeCommonName](http://www.mbsplugins.eu/CalendarItemGetAttendeeCommonName.shtml), [Calendar.Item.GetAttendeeStatus](http://www.mbsplugins.eu/CalendarItemGetAttendeeStatus.shtml), [Printer.PrinterName](http://www.mbsplugins.eu/PrinterPrinterName.shtml) and [CLGeocoder.PlacemarkValue](http://www.mbsplugins.eu/CLGeocoderPlacemarkValue.shtml).
- **Version 7.5**
    - Enabled [CoreLocation](http://www.mbsplugins.eu/component_CoreLocation.shtml) and [CLGeocoder](http://www.mbsplugins.eu/component_CLGeocoder.shtml) functions for iOS.

### Blog Entries

- [Use MapKit to validate addresses](https://www.mbsplugins.de/archive/2024-02-15/Use_MapKit_to_validate_address/monkeybreadsoftware_blog_filemaker)
- [New in the MBS FileMaker Plugin 10.1](https://www.mbsplugins.de/archive/2020-03-17/New_in_the_MBS_FileMaker_Plugi/monkeybreadsoftware_blog_filemaker)
- [Neues MBS FileMaker Plugin 10.1 - Über 6100 Funktionen in einem Plugin](https://www.mbsplugins.de/archive/2020-03-10/Neues_MBS_FileMaker_Plugin_101/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 10.1 - More than 6100 Functions In One Plugin](https://www.mbsplugins.de/archive/2020-03-10/MBS_FileMaker_Plugin_101_-_Mor/monkeybreadsoftware_blog_filemaker)
- [Core Location Geocoder with JSON](https://www.mbsplugins.de/archive/2020-02-12/Core_Location_Geocoder_with_JS/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 7.5 - Über 5000 Funktionen in einem Plugin](https://www.mbsplugins.de/archive/2017-11-28/MBS_FileMaker_Plugin_75_-_Übe/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 7.5 - More than 5000 Functions In One Plugin](https://www.mbsplugins.de/archive/2017-11-28/MBS_FileMaker_Plugin_75_-_More/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 7.5pr9](https://www.mbsplugins.de/archive/2017-11-23/MBS_FileMaker_Plugin_version_7/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plug-in 6.1 for OS X/Windows](https://www.mbsplugins.de/archive/2016-03-08/MBS_FileMaker_Plug-in_61_for_O/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 4.1 for OS X/Windows - More than 2400 Functions In One Plugin](https://www.mbsplugins.de/archive/2014-03-18/MBS_FileMaker_Plugin_41_for_OS/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 2/2022, Seite 31](https://filemaker-magazin.de/neuigkeit/4174-Appetithappen-FMM_202202)

### Example Databases

- [Mac and iOS/CoreLocation/Address Mapping](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/CoreLocation/Address%20Mapping.shtml#12912FieldAnchor_)
- [Mac and iOS/CoreLocation/CLGeocoder](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/CoreLocation/CLGeocoder.shtml#1ScriptAnchor_)
- [Mac and iOS/MapKit/MapView BeeExample](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/MapKit/MapView%20BeeExample.shtml#16ScriptAnchor_)
- [Mac and iOS/MapKit/Validate Address](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/MapKit/Validate%20Address.shtml#1ScriptAnchor_)

[HTML Version](component_CLGeocoder.shtml)