Coordinates
A coords
value is a basic set of coordinates (latitude & longitude) in a simple JSON format:
{
"lat": 32.3113966,
"lng": -64.7527469
}
To be clear, coordinates are not actually a Model (and so this page technically doesn't belong here). But the format of coords
is commonly used throughout the plugin, which gives coordinates a pseudo-model behavior.
# Common Format
A set of coordinates is handled in this common format. Any place you encounter a coords
value, it will be handled in this format. Here are just a few examples of where you'd see a set of coordinates in this format:
Where | Specifically | |
---|---|---|
Maps | As the center point of a map. | Reference |
Info Windows | As a predefined value in an info window template. | Reference |
Proximity Search | As the target of a proximity search. | Reference |
Geocoding (Lookup) | In a set of geocoding results. | Reference |
Address Fields | Available on the parent Location Model. | Reference |
Visitor Geolocation | Available on the parent Location Model. | Reference |
# Google Maps Coordinates
The internal format of coords
aligns with the established format of a Google Maps LatLngLiteral
object (opens new window). Since the two formats are effectively identical, you can use the values interchangeably.
Nearly Identical
Roughly speaking, you can say that the Google Maps plugin "uses" the LatLngLiteral
to handle coordinates internally. There may be some subtle differences, but you can generally treat them as the same thing and not encounter any issues.