ARCore is back at Google I/O on May 10! Register now.
Stay organized with collections Save and categorize content based on your preferences.


Category adding Geospatial functionality to GARSessionConfiguration.



Describes the desired behavior of the ARCore Geospatial API.



@property(nonatomic) GARGeospatialMode geospatialMode;

Describes the desired behavior of the ARCore Geospatial API.

The Geospatial API uses a combination of Google's Visual Positioning System (VPS) and GPS to determine the geospatial pose.

The Geospatial API is able to provide the best user experience when it is able to generate high accuracy poses. However, the Geospatial API can be used anywhere, as long as the device is able to determine its location, even if the available location information has low accuracy.

  • In areas with VPS coverage, the Geospatial API is able to generate high accuracy poses. This can work even where GPS accuracy is low, such as dense urban environments. Under typical conditions, VPS can be expected to provide positional accuracy typically better than 5 meters and often around 1 meter, and a rotational accuracy of better than 5 degrees. Use checkVPSAvailabilityAtCoordinate:completionHandler: (GARSession(Geospatial)) to determine if a given location has VPS coverage.
  • In outdoor environments with few or no overhead obstructions, GPS may be sufficient to generate high accuracy poses. GPS accuracy may be low in dense urban environments and indoors.

A small number of ARCore supported devices do not support the Geospatial API. Use isGeospatialModeSupported: (GARSession(Geospatial)) to determine if the current device is supported. Affected devices are also indicated on the ARCore supported devices page.

The default mode is GARGeospatialModeDisabled. If the mode is changed, existing Geospatial anchors will stop tracking.

Remember to set a credential for authentication with Google Cloud before configuring, or you may receive auth errors. See sessionWithAPIKey:bundleIdentifier:error: (GARSession) and setAuthToken: (GARSession), as well as documentation on Enable the Geospatial API.

Configuring may result in the following error codes: