GoogleMaps Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
GMSGeometryContainsLocation
extern BOOL GMSGeometryContainsLocation(CLLocationCoordinate2D point,
GMSPath *_Nonnull path, BOOL geodesic)
Returns whether point
lies inside of path. The path is always considered closed, regardless of
whether the last point equals the first or not.
Inside is defined as not containing the South Pole – the South Pole is always outside.
path
describes great circle segments if geodesic
is YES, and rhumb (loxodromic) segments
otherwise.
If point
is exactly equal to one of the vertices, the result is YES. A point that is not equal
to a vertex is on one side or the other of any path segment – it can never be “exactly on the
border”.
See GMSGeometryIsLocationOnPath()
for a border test with tolerance.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 UTC."],[],["The function `GMSGeometryContainsLocation` determines if a given `point` is within a defined `path`. The path is treated as closed, and the South Pole is always considered outside. The `geodesic` parameter dictates whether the path segments are great circle or rhumb lines. If the `point` matches a path vertex, it's considered inside. A point is always either inside or outside, never exactly on the path's border. `GMSGeometryIsLocationOnPath` provides a border test with tolerance.\n"],null,[]]