Overview
Defines a mapping between Earth coordinates (CLLocationCoordinate2D) and coordinates in the map's view (CGPoint).
A projection is constant and immutable, in that the mapping it embodies never changes. The mapping is not necessarily linear.
Passing invalid Earth coordinates (i.e., per CLLocationCoordinate2DIsValid) to this object may result in undefined behavior.
This class should not be instantiated directly unless under testing conditions. Instead, obtain it via projection on GMSMapView.
Public Member Functions | |
| (CGPoint) | - pointForCoordinate: |
| Maps an Earth coordinate to a point coordinate in the map's view. | |
| (CLLocationCoordinate2D) | - coordinateForPoint: |
| Maps a point coordinate in the map's view to an Earth coordinate. | |
| (CGFloat) | - pointsForMeters:atCoordinate: |
| Converts a distance in meters to content size. | |
| (BOOL) | - containsCoordinate: |
| Returns whether a given coordinate (lat/lng) is contained within the projection. | |
| (GMSVisibleRegion) | - visibleRegion |
| Returns the region (four location coordinates) that is visible according to the projection. | |
Member Function Documentation
| - (CGPoint) pointForCoordinate: | (CLLocationCoordinate2D) | coordinate |
Maps an Earth coordinate to a point coordinate in the map's view.
| - (CLLocationCoordinate2D) coordinateForPoint: | (CGPoint) | point |
Maps a point coordinate in the map's view to an Earth coordinate.
| - (CGFloat) pointsForMeters: | (CLLocationDistance) | meters | |
| atCoordinate: | (CLLocationCoordinate2D) | coordinate | |
Converts a distance in meters to content size.
This is only accurate for small Earth distances, as it uses CGFloat for screen distances.
| - (BOOL) containsCoordinate: | (CLLocationCoordinate2D) | coordinate |
Returns whether a given coordinate (lat/lng) is contained within the projection.
Returns the region (four location coordinates) that is visible according to the projection.
If padding was set on GMSMapView, this region takes the padding into account.
The visible region can be non-rectangular. The result is undefined if the projection includes points that do not map to anywhere on the map (e.g., camera sees outer space).