How to load a VPS Spot with customized AR gameobjects using CoverageAPI?

Include the following details (edit as applicable):

  • Issue category: VPS
  • Device type & OS version: iOS
  • Host machine & OS version: Mac
  • Xcode version: 16.4
  • ARDK version: 3.15
  • Unity version: 2022.3.50f1

Description of the issue:

Hi all,

I’m developing an AR app using ARDK 3.15 and I’ve successfully integrated VPS and the VPS Coverage API following the official tutorials. At this point, I can query nearby VPS spots and localize correctly.

What I’d like to do next is associate custom AR game objects (which I placed in Unity using the mesh downloaded from the Geospatial Browser) with those VPS locations, so that when users visit a specific VPS spot, they can see the pre-placed content.

From the documentation, I understand that the Coverage API returns a default anchor as part of the LocalizationTarget, and meshes downloaded from the Geospatial Browser also provide an ARLocation with a default anchor. My question is:

  • How can I extend or replace this default anchor with one that includes my customized AR content?

  • Is the correct workflow to save these objects as persistent anchors and then reload them when the user localizes at that spot?

  • Or is there another way to “export” my custom scene data so it is tied to that VPS location?

Thanks in advance for any guidance!

Zhenlin

Hello,

Have you had a chance to check out our How To on using Location AR to place your own AR Content? https://lightship.dev/docs/ardk/how-to/vps/real_world_location_ar/

HI Jesus,

Thanks for your reply! I have already done that step. I do know how to place my own AR content into a scene, according to the link you told me. But my question is how to dynamically load the VPS content with my customized AR content using coverage API. This How To does not use coverage API.

For example, if I am in a university campus and I have several VPS-activated spots available. When I navigate within the campus, the coverage API can search for the nearby VPS spots for me, and I could choose which spots I would like to track. But how could I set up the ARLocationManager to load a VPS location with my customized AR content? I mean think a VPS location with my customized AR content as a prefab of ARLocation. OR I need to manually spawn these customized AR content as the child of the ARLocation for each tracked spots.

Best,

Zhenlin

Have you had a chance to take a look at this other guide we have? It shows how to use the Coverage Client as well as how to use the output of the Client with the AR Location Manager: https://lightship.dev/docs/ardk/how-to/vps/querying_vps_coverage/

This other guide. If you have a set number of predefined areas that you want your content to appear in you might also want to check this out: https://lightship.dev/docs/ardk/how-to/vps/location_ar_code/ It’s similar to the one linked above but tuned more for when you have a set number of Locations you know you’re going to use