Informatie over de klasse AnchorLocateCriteriaUnderstanding the AnchorLocateCriteria class

In dit artikel vindt u informatie over de verschillende opties die u kunt gebruiken bij het uitvoeren van een query op een anker.In this article you will learn the different options you can use when querying an anchor. We gaan over de AnchorLocateCriteria-klasse, de opties en geldige combi Naties van oplossingen.We will go over the AnchorLocateCriteria class, its options and valid option combinations.

Criteria voor anker zoekenAnchor locate criteria

De AnchorLocateCriteria-klasse helpt u bij het opvragen van de service voor eerder gemaakte ankers.The AnchorLocateCriteria class helps you query the service for previously created anchors. Eén AnchorLocateCriteria-object kan op elk gewenst moment per Watcher worden gebruikt.One AnchorLocateCriteria object may be used per watcher at any time. Elk AnchorLocateCriteria-object moet exact een van de volgende eigenschappen bevatten: identifiers, NearAnchorof NearDevice.Each AnchorLocateCriteria object must include exactly one of the following properties: Identifiers, NearAnchor, or NearDevice. Aanvullende eigenschappen, zoals strategie, BypassCacheen RequestedCategories , kunnen worden ingesteld indien gewenst.Additional properties such as Strategy, BypassCache, and RequestedCategories can be set if desired.

EigenschappenProperties

Definieer exact een van de volgende eigenschappen in de Watcher:Define exactly one of the following properties in your watcher:

Id'sIdentifiers

Standaard waarde: lege teken reeks matrixDefault Value: empty string array

Met behulp van Id's kunt u een lijst met anker-Id's definiëren voor ankers die u wilt zoeken.Using Identifiers, you can define a list of anchor IDs for anchors you would like to locate. Anker-Id's worden in eerste instantie naar u geretourneerd nadat het maken van een anker is geslaagd.Anchor IDs are initially returned to you after successful anchor creation. Met de opgegeven Id's wordt met AnchorLocateCriteria de set aangevraagde ankers beperkt tot ankers met overeenkomende anker-Id's.With Identifiers specified, AnchorLocateCriteria restricts the set of requested anchors to anchors with matching anchor IDs. Deze eigenschap wordt opgegeven met behulp van een teken reeks matrix.This property is specified using a string array.

NearAnchorNearAnchor

Standaard waarde: niet ingesteldDefault Value: not set

Met NearAnchor kunt u opgeven dat AnchorLocateCriteria de set aangevraagde ankers beperkt tot ankers binnen een gewenste afstand van een gekozen anker.Using NearAnchor, you can specify that AnchorLocateCriteria restricts the set of requested anchors to anchors within a desired distance away from a chosen anchor. U moet dit gekozen anker opgeven als bron anker.You must provide this chosen anchor as the source anchor. U kunt ook de gewenste afstand van het bron anker instellen, en het maximum aantal geretourneerde ankers om de zoek opdracht verder te beperken.You may also set the desired distance away from the source anchor, and the maximum number of anchors returned, to further limit the search. Deze eigenschap wordt opgegeven met behulp van een NearAnchorCriteria-object.This property is specified using a NearAnchorCriteria object.

NearDeviceNearDevice

Standaard waarde: niet ingesteldDefault Value: not set

Met NearDevice kunt u opgeven dat de set aangevraagde ankers door AnchorLocateCriteria wordt beperkt tot de fysieke locatie van het apparaat.Using NearDevice, you can specify that AnchorLocateCriteria restricts the set of requested anchors to those close to the device’s physical location. Alle ingeschakelde Sens oren worden gebruikt om ankers rond uw apparaat te ontdekken.Any enabled sensors will be used to help discover anchors around your device. Als u de beste kans hebt om ankers te vinden, moet u SensorCapabilities configureren om de sessie toegang te geven tot alle geschikte Sens oren.To have the best chance of finding anchors, you should configure SensorCapabilities to give the session access to all appropriate sensors. Voor meer informatie over het instellen en gebruiken van deze eigenschap raadpleegt u Grove relokalisatie-Azure spatiale ankers | Microsoft docs en het maken en vinden van ankers met ruwe Herlokalisatie in C#, objectief-C, Swift, Java, c++/ndk, c++/WinRT.For more information on setting up and using this property, see 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.This property is specified using a NearDeviceCriteria object.

Aanvullende eigenschappenAdditional properties

BypassCacheBypassCache

Standaard waarde: FalseDefault Value: false

Wanneer een anker is gemaakt of in een sessie is gevonden, wordt deze ook opgeslagen in de cache.When an anchor has been created or found in a session, it is also stored in the cache. Als deze eigenschap is ingesteld op False, retourneert elke volgende query in dezelfde sessie de waarde in de cache.With this property set to false, any subsequent query in the same session will return the cached value. Er is geen aanvraag naar de ASA-service gedaan.No request to the ASA service is made.

RequestedCategoriesRequestedCategories

Standaard waarde: eigenschappen | RuimtelijkeDefault Value: Properties | Spatial

Deze eigenschap wordt gebruikt om te bepalen welke gegevens worden geretourneerd door een query met behulp van AnchorLocateCriteria.This property is used to determine what data is returned from a query using AnchorLocateCriteria. De standaard waarde retourneert zowel eigenschappen als ruimtelijke gegevens. Dit mag niet worden gewijzigd als de eigenschappen en ruimtelijke gegevens beide gewenst zijn.The default value returns both properties and spatial data, this should not be changed if properties and spatial data are both desired. Deze eigenschap kan worden opgegeven met de opsomming AnchorDataCategory.This property can be specified using the AnchorDataCategory enum.

AnchorDataCategory Enum-waardeAnchorDataCategory Enum Value Geretourneerde gegevensReturned Data
GeenNone Er zijn geen gegevens geretourneerdNo data is returned
EigenschappenProperties Anker eigenschappen, waaronder AppProperties, worden geretourneerd.Anchor properties including AppProperties are returned.
RuimtelijkSpatial Ruimtelijke informatie over een anker wordt geretourneerd.Spatial information about an anchor is returned.

StrategieStrategy

Standaard waarde: AnyStrategyDefault Value: AnyStrategy

Strategie bepaalt hoe ankers moeten worden gevonden.Strategy further defines how anchors should be located. De strategie-eigenschap kan worden opgegeven met behulp van een LocateStrategy Enum.The Strategy property may be specified using a LocateStrategy enum.

LocateStrategy Enum-waardeLocateStrategy Enum Value DescriptionDescription
AnyStrategyAnyStrategy Met deze strategie kan het systeem combi Naties van VisualInformation-en relatie strategieën gebruiken om ankers te vinden.This strategy permits the system to use combinations of VisualInformation and Relationship strategies to find anchors.
VisualInformationVisualInformation Deze strategie probeert ankers te vinden door de visuele informatie van de huidige omgeving te vergelijken met die van de visuele footprint van het anker.This strategy attempts to find anchors by matching visual information from the current surroundings to those of the anchor’s visual footprint. De visuele footprint van een anker verwijst naar de visuele informatie die momenteel aan het anker is gekoppeld.An anchor’s visual footprint refers to the visual information currently associated with the anchor. Deze visuele informatie wordt doorgaans niet alleen verzameld tijdens het maken van het anker.This visual information is typically but not exclusively gathered during anchor creation. Deze strategie is op dit moment alleen toegestaan in combi natie met de eigenschappen NearDevice of identifiers.Currently, this strategy is only permitted in conjunction with the NearDevice or Identifiers properties.
RelatieRelationship Deze strategie probeert ankers te vinden door gebruik te maken van bestaande verbonden ankers.This strategy attempts to find anchors by making use of existing connected anchors. Deze strategie is op dit moment alleen toegestaan in combi natie met de eigenschappen NearAnchor of identifiers.Currently, this strategy is only permitted in conjunction with the NearAnchor or Identifiers properties. In combi natie met de eigenschap identifiers is het vereist dat de gebruiker in dezelfde sessie eerder een anker (s) heeft gevonden met reeds gemaakte verbindings relaties met de ankers waarvan de Id's zijn opgegeven in de ID-matrix.When used with the Identifiers property, it is required that, in the same session, the user should have previously located an anchor(s) with already established connective relationships to the anchors whose IDs are specified in the Identifiers array.

Geldige combi Naties van eigenschappen LocateStrategy en AnchorLocateCriteriaValid combinations of LocateStrategy and AnchorLocateCriteria properties

Niet alle combi Naties van strategie-en AnchorLocateCriteria-eigenschappen zijn momenteel toegestaan door het systeem.Not all combinations of Strategy and AnchorLocateCriteria properties are currently permitted by the system. In de volgende tabel ziet u de toegestane combi Naties:The following table shows the allowed combinations:

EigenschapProperty AnyStrategyAnyStrategy RelatieRelationship VisualInformationVisualInformation
Id'sIdentifiers
NearAnchorNearAnchor ✓ (wordt standaard ingesteld op relatie)✓ (will default to Relationship)
NearDeviceNearDevice

Volgende stappenNext steps

Zie ankers maken en vinden met behulp van ruimtelijke ankers voor meer voor beelden met behulp van de AnchorLocateCriteria-klasse.See How to create and locate anchors using Azure Spatial Anchors for some more examples using the AnchorLocateCriteria class.