Cloud Anchors Developer Guide for Android

Learn about working with cloud anchors in your own apps.

If you are new to cloud anchors, see the quickstart first for system requirements, setup, and installation instructions.

Enabling cloud anchors in your app

By default, cloud anchors are disabled in ARCore. You can enable cloud anchor capabilities in your ARCore Session configuration.

Note that the ARCore Cloud Anchors sample app ships with cloud anchors enabled for demo purposes only.

Performance considerations

Note the following when enabling cloud anchor capabilities in your app:

  • Memory usage will increase when you enable cloud anchors.

  • Battery usage is expected to increase because of network usage and increased memory requirements.

API Quotas

The ARCore Cloud Anchor API has the following quotas for request bandwidth:

Quota type Maximum Duration Applies to
Number of anchors Unlimited N/A Project
Anchor host requests 30 minute IP address and project
Anchor resolve requests 300 minute IP address and project

Best practices

The following best practices help create a good cloud anchors user experience.

General

  • Avoid hosting or resolving cloud anchors on shiny surfaces.
    • For best results, avoid reflective surfaces or surfaces without visual features, such as a blank, smooth, white wall.
  • Make sure that the lighting in the room is sufficient.
  • For best results, lighting conditions should be consistent between anchor host and resolve requests.

Hosting

Before hosting an anchor:

  • Try to look at the anchor from different angles.
  • Move around the anchor for at least a few seconds.
  • Make sure you are not too far away from the anchor.

Resolving

When resolving an anchor:

  • Make sure you are close to where the anchor was hosted.
    • If you are too far away from a cloud anchor’s position, it might resolve incorrectly.
  • A cloud anchor might resolve incorrectly if your device camera is pointed at a space that is different from but visually identical to where the cloud anchor was hosted.

Next steps

Send feedback about...