Förstå klassen AnchorLocateCriteria

I den här artikeln får du lära dig de olika alternativ som du kan använda när du kör frågor mot en fästpunkt. Vi går igenom klassen AnchorLocateCriteria, dess alternativ och giltiga alternativkombinationer.

Villkor för fästpunktslokalisering

Klassen AnchorLocateCriteria hjälper dig att fråga efter tidigare skapade fästpunkter i tjänsten. Ett AnchorLocateCriteria-objekt kan användas per bevakare när som helst. Varje AnchorLocateCriteria-objekt måste innehålla exakt en av följande egenskaper: Identifierare, NearAnchor eller NearDevice. Ytterligare egenskaper som Strategi, BypassCache och RequestedCategories kan anges om du vill.

Egenskaper

Definiera exakt en av följande egenskaper i din bevakare:

Identifiers

Standardvärde: tom strängmatris

Med identifierare kan du definiera en lista över fästpunkts-ID:er för fästpunkter som du vill hitta. Fästpunkts-ID:t returneras ursprungligen till dig efter att fästpunkt har skapats. Med Angivna identifierare begränsar AnchorLocateCriteria uppsättningen begärda fästpunkter till fästpunkter med matchande fästpunkts-ID: er. Den här egenskapen anges med hjälp av en strängmatris.

NearAnchor

Standardvärde: inte inställt

Med NearAnchor kan du ange att AnchorLocateCriteria begränsar uppsättningen begärda fästpunkter till fästpunkter inom ett önskat avstånd från ett valt fästpunkt. Du måste ange den valda fästpunkten som källankare. Du kan också ange det önskade avståndet bort från källankaret och det maximala antalet fästpunkter som returneras för att ytterligare begränsa sökningen. Den här egenskapen anges med hjälp av ett NearAnchorCriteria-objekt.

NearDevice

Standardvärde: inte inställt

Med Hjälp av NearDevice kan du ange att AnchorLocateCriteria begränsar uppsättningen begärda fästpunkter till dem som ligger nära enhetens fysiska plats. Alla aktiverade sensorer används för att identifiera fästpunkter runt din enhet. För att få bästa möjliga chans att hitta fästpunkter bör du konfigurera SensorCapabilities för att ge sessionen åtkomst till alla lämpliga sensorer. Mer information om hur du konfigurerar och använder den här egenskapen finns i Coarse Relocalization – Azure Spatial Anchors | Microsoft Docs och How to create and locate anchors using coarse relocalization in C#, Objective-C, Swift, Java, C++/NDK, C++/WinRT. Den här egenskapen anges med hjälp av ett NearDeviceCriteria-objekt.

Ytterligare egenskaper

BypassCache

Standardvärde: false

När en fästpunkt har skapats eller hittats i en session lagras den också i cacheminnet. Med den här egenskapen inställd på false returnerar alla efterföljande frågor i samma session det cachelagrade värdet. Ingen begäran till ASA-tjänsten görs.

RequestedCategories

Standardvärde: Egenskaper | Rumsliga

Den här egenskapen används för att avgöra vilka data som returneras från en fråga med hjälp av AnchorLocateCriteria. Standardvärdet returnerar både egenskaper och rumsliga data. Detta bör inte ändras om både egenskaper och rumsliga data önskas. Den här egenskapen kan anges med anchorDataCategory-uppräkningen.

AnchorDataCategory Uppräkningsvärde	Returnerade data
None	Inga data returneras
Egenskaper	Fästpunktsegenskaper inklusive AppProperties returneras.
Rumslig	Rumslig information om en fästpunkt returneras.

Strategi

Standardvärde: AnyStrategy

Strategin definierar ytterligare hur fästpunkter ska placeras. Egenskapen Strategi kan anges med en LocateStrategy-uppräkning.

LocateStrategy Uppräkningsvärde	Description
AnyStrategy	Med den här strategin kan systemet använda kombinationer av VisualInformation- och Relationsstrategier för att hitta fästpunkter.
VisualInformation	Den här strategin försöker hitta fästpunkter genom att matcha visuell information från den aktuella omgivningen till fästpunktens visuella fotavtryck. Ett fästpunkts visuella fotavtryck refererar till den visuella information som för närvarande är associerad med fästpunkten. Den här visuella informationen samlas vanligtvis in men samlas inte enbart in när fästpunkt skapas. För närvarande är den här strategin endast tillåten tillsammans med egenskaperna NearDevice eller Identifierare.
Relation	Den här strategin försöker hitta fästpunkter genom att använda befintliga anslutna fästpunkter. För närvarande är den här strategin endast tillåten tillsammans med egenskaperna NearAnchor eller Identifierare. När den används med egenskapen Identifierare krävs det att användaren i samma session tidigare har hittat en fästpunkt med redan etablerade anslutningsrelationer till fästpunkterna vars ID anges i matrisen Identifierare.

Giltiga kombinationer av egenskaperna LocateStrategy och AnchorLocateCriteria

Alla kombinationer av egenskaperna Strategi och AnchorLocateCriteria tillåts för närvarande inte av systemet. I följande tabell visas de tillåtna kombinationerna:

Property	AnyStrategy	Relation	VisualInformation
Identifiers	✓	✓	✓
NearAnchor	√ (kommer som standard att vara Relation)	✓
NearDevice	✓		✓

Nästa steg

Se Skapa och hitta fästpunkter med Hjälp av Azure Spatial Anchors för några fler exempel med klassen AnchorLocateCriteria.