Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

CLGeocoder.PlacemarkValue

Queries a value of the placemarks found.

Component Version macOS Windows Linux Server iOS SDK
CLGeocoder 4.1 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CLGeocoder.PlacemarkValue"; Geocoder; Index; Selector { ; otherLatitude; otherLongitude } )   More

Parameters

Parameter Description Example Flags
Geocoder The reference number of the geocoder instance. $Geocoder
Index The index of the placemark. From 0 to CLGeocoder.PlacemarkCount-1. 0
Selector Which property to return. "Name"
otherLatitude For distance calculation the latitude of the other place. $lat Optional
otherLongitude For distance calculation the longitude of the other place. $lon Optional

Result

Returns value or error.

Description

Queries a value of the placemarks found.
Possible values for selector:
nameThe name of the placemark.
thoroughfareThe street address associated with the placemark. The street address contains the street name. For example, if the placemark location is Apple's headquarters, the value for this property would be the string "Infinite Loop”.
subThoroughfareAdditional street-level information for the placemark. Subthroughfares provide information such as the street number for the location. For example, if the placemark location is Apple's headquarters (1 Infinite Loop), the value for this property would be the string "1”.
localityThe city associated with the placemark. If the placemark location is Apple's headquarters, for example, the value for this property would be the string "Cupertino”.
subLocalityAdditional city-level information for the placemark. This property contains additional information, such as the name of the neighborhood or landmark associated with the placemark. It might also refer to a common name that is associated with the location.
administrativeAreaThe state or province associated with the placemark. The string in this property can be either the spelled out name of the administrative area or its designated abbreviation, if one exists. If the placemark location is Apple's headquarters, for example, the value for this property would be the string "CA” or "California”.
subAdministrativeAreaAdditional administrative area information for the placemark. Subadministrative areas typically correspond to counties or other regions that are then organized into a larger administrative area or state. For example, if the placemark location is Apple's headquarters, the value for this property would be the string "Santa Clara”, which is the county in California that contains the city of Cupertino.
postalCodeThe postal code associated with the placemark. If the placemark location is Apple's headquarters, for example, the value for this property would be the string "95014”.
ISOcountryCodeThe abbreviated country name. This string is the standard abbreviation used to refer to the country. For example, if the placemark location is Apple's headquarters, the value for this property would be the string "US”.
countryThe name of the country associated with the placemark. f the placemark location is Apple's headquarters, for example, the value for this property would be the string "United States”.
inlandWaterThe name of the inland water body associated with the placemark. For coordinates that lie over an inland body of water, this property contains the name of that water body—the name of a lake, stream, river, or other waterway.
oceanThe name of the ocean associated with the placemark. For coordinates that lie over an ocean, this property contains the name of the ocean.
areasOfInterestThe relevant areas of interest associated with the placemark. Examples of an area of interest are the name of a military base or large national park or an attraction such as Eiffel Tower, Disneyland, or Golden Gate Park. This is a list of several texts.
region.radiusThe radius of the geographic region associated with the placemark.
region.center.latitudeThe latitude of the geographic region associated with the placemark.
region.center.longitudeThe longitude of the geographic region associated with the placemark.
region.identifierThe identifier of the geographic region associated with the placemark.
addressThe formatted address.
location.horizontalAccuracyThe horizontal accuracy of the location.
location.verticalAccuracyThe vertical accuracy of the location.
location.altitudeThe altitude of the location.
location.timestampThe timestamp of the location.
location.descriptionThe description text of the location.
location.latitudeThe latitude of the location.
location.longitudeThe longitude of the location.
distanceCalculates the distance t another location. Please provide the other place with additional parameters. Returns value in meters.

Examples

Query name of the first placemark:

$name = MBS("CLGeocoder.PlacemarkValue"; $g; 0; "name")

Queries the coordinates of the placemark:

$latitude = MBS("CLGeocoder.PlacemarkValue"; $g; 0; "location.latitude")
$longitude = MBS("CLGeocoder.PlacemarkValue"; $g; 0; "location.longitude")

Queries distance to New York:

$distance = MBS("CLGeocoder.PlacemarkValue"; $g; 0; "distance"; 40,712778; -74,005833)

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 8th February 2024


CLGeocoder.PlacemarkCount - CLGeocoder.ReverseGeocodeLocation