Inzicht in de klasse AnchorLocateCriteria

In dit artikel leert u de verschillende opties die u kunt gebruiken bij het uitvoeren van query's op een anker. We nemen de klasse AnchorLocateCriteria, de opties en geldige optiecombinaties door.

Criteria voor het zoeken van ankers

Met de klasse AnchorLocateCriteria kunt u query's uitvoeren op de service voor eerder gemaakte ankers. Eén AnchorLocateCriteria-object kan op elk gewenst moment per watcher worden gebruikt. Elk AnchorLocateCriteria-object moet precies een van de volgende eigenschappen bevatten: Id's, NearAnchor of NearDevice. Aanvullende eigenschappen, zoals Strategy, BypassCache en RequestedCategories , kunnen desgewenst worden ingesteld.

Eigenschappen

Definieer precies een van de volgende eigenschappen in uw watcher:

Identifiers

Standaardwaarde: lege tekenreeksmatrix

Met id's kunt u een lijst met anker-id's definiëren voor ankers die u wilt zoeken. Anker-id's worden in eerste instantie aan u geretourneerd nadat het anker is gemaakt. Met id's opgegeven beperkt AnchorLocateCriteria de set aangevraagde ankers tot ankers met overeenkomende anker-id's. Deze eigenschap wordt opgegeven met behulp van een tekenreeksmatrix.

NearAnchor

Standaardwaarde: niet ingesteld

Met NearAnchor kunt u opgeven dat AnchorLocateCriteria de set aangevraagde ankers beperkt tot ankers op een gewenste afstand van een gekozen anker. U moet dit gekozen anker opgeven als bronanker. U kunt ook de gewenste afstand van het bronanker en het maximum aantal geretourneerde ankers instellen om de zoekopdracht verder te beperken. Deze eigenschap wordt opgegeven met behulp van een NearAnchorCriteria-object.

NearDevice

Standaardwaarde: niet ingesteld

Met NearDevice kunt u opgeven dat AnchorLocateCriteria de set aangevraagde ankers beperkt tot de ankers in de buurt van de fysieke locatie van het apparaat. Alle ingeschakelde sensoren worden gebruikt om ankers rond uw apparaat te detecteren. Als u de beste kans wilt hebben om ankers te vinden, moet u SensorCapabilities configureren om de sessie toegang te geven tot alle geschikte sensoren. Zie Coarse Relocalization - Azure Spatial Anchors | Microsoft Docs and How to create and locate anchors using coarse relocalization in C#, Objective-C, Swift, Java, C++/NDK, C++/WinRT. Deze eigenschap wordt opgegeven met behulp van een NearDeviceCriteria-object.

Aanvullende eigenschappen

BypassCache

Standaardwaarde: onwaar

Wanneer een anker is gemaakt of gevonden in een sessie, wordt het ook opgeslagen in de cache. Als deze eigenschap is ingesteld op onwaar, retourneert elke volgende query in dezelfde sessie de waarde in de cache. Er wordt geen aanvraag voor de ASA-service ingediend.

RequestedCategories

Standaardwaarde: Eigenschappen | Ruimtelijke

Deze eigenschap wordt gebruikt om te bepalen welke gegevens worden geretourneerd uit een query met behulp van AnchorLocateCriteria. De standaardwaarde retourneert zowel eigenschappen als ruimtelijke gegevens. Dit mag niet worden gewijzigd als eigenschappen en ruimtelijke gegevens beide gewenst zijn. Deze eigenschap kan worden opgegeven met behulp van de enum AnchorDataCategory.

AnchorDataCategory Enum-waarde	Geretourneerde gegevens
Geen	Er worden geen gegevens geretourneerd
Eigenschappen	Ankereigenschappen, waaronder AppProperties, worden geretourneerd.
Ruimtelijk	Ruimtelijke informatie over een anker wordt geretourneerd.

Strategie

Standaardwaarde: AnyStrategy

Strategie definieert verder hoe ankers zich moeten bevinden. De eigenschap Strategie kan worden opgegeven met behulp van een Enum LocateStrategy.

LocateStrategy Enum-waarde	Omschrijving
AnyStrategy	Met deze strategie kan het systeem combinaties van VisualInformation- en Relatiestrategieën gebruiken om ankers te vinden.
VisualInformation	Deze strategie probeert ankers te vinden door visuele informatie uit de huidige omgeving te koppelen aan die van de visuele footprint van het anker. De visuele footprint van een anker verwijst naar de visuele informatie die momenteel aan het anker is gekoppeld. Deze visuele informatie wordt doorgaans, maar niet uitsluitend verzameld tijdens het maken van ankers. Deze strategie is momenteel alleen toegestaan in combinatie met de eigenschappen NearDevice of Identifiers.
Relatie	Deze strategie probeert ankers te vinden door gebruik te maken van bestaande verbonden ankers. Deze strategie is momenteel alleen toegestaan in combinatie met de eigenschappen NearAnchor of Identifiers. Wanneer deze wordt gebruikt met de eigenschap Id's, is het vereist dat de gebruiker in dezelfde sessie eerder een anker(s) met reeds tot stand gebrachte verbindingsrelaties heeft met de ankers waarvan de id's zijn opgegeven in de matrix Id's.

Geldige combinaties van eigenschappen LocateStrategy en AnchorLocateCriteria

Niet alle combinaties van eigenschappen Strategie en AnchorLocateCriteria zijn momenteel toegestaan door het systeem. In de volgende tabel ziet u de toegestane combinaties:

Eigenschappen	AnyStrategy	Relatie	VisualInformation
Identifiers	✓	✓	✓
NearAnchor	✓ (wordt standaard ingesteld op Relatie)	✓
NearDevice	✓		✓

Volgende stappen

Zie Ankers maken en zoeken met behulp van Azure Spatial Anchors voor enkele voorbeelden met behulp van de klasse AnchorLocateCriteria.