Sammansättning av hyllbild (förhandsversion)

Artikel
10/17/2024

Viktigt!

Den här funktionen är nu inaktuell. Den 31 mars 2025 kommer API:et för anpassad bildanalys 4.0 för Azure AI Image Analysis 4.0, anpassad objektidentifiering och förhandsversion av produktigenkänning att dras tillbaka. Efter det här datumet misslyckas API-anrop till dessa tjänster.

För att upprätthålla en smidig drift av dina modeller övergår du till Azure AI Custom Vision, som nu är allmänt tillgängligt. Custom Vision erbjuder liknande funktioner som dessa funktioner för att dra tillbaka.

En del av arbetsflödet för produktigenkänning handlar om att åtgärda och ändra indatabilderna så att tjänsten kan fungera korrekt.

Den här guiden visar hur du använder Stitching API för att kombinera flera bilder av samma fysiska hylla: detta ger dig en sammansatt bild av hela butikshyllan, även om den bara visas delvis av flera olika kameror.

Den här guiden visar också hur du använder API:et för korrigering för att korrigera för perspektivförvrängning när du sammanfogar olika bilder.

Förutsättningar

En Azure-prenumeration – Skapa en kostnadsfritt
När du har din Azure-prenumeration skapar du en Vision-resurs i Azure Portal. Den måste distribueras i en Azure-region som stöds (se Regiontillgänglighet). När den har distribuerats väljer du Gå till resurs.
- Du behöver nyckeln och slutpunkten från den resurs som du skapar för att ansluta ditt program till Azure AI Vision-tjänsten. Du klistrar in nyckeln och slutpunkten i koden nedan senare i snabbstarten.
En Azure Storage-resurs med en bloblagringscontainer. Skapa en
cURL installerat. Eller så kan du använda en annan REST-plattform, till exempel Swagger eller REST-klienttillägget för VS Code.
En uppsättning foton som visar intilliggande delar av samma hylla. En överlappning på 50 % mellan bilder rekommenderas. Du kan ladda ned och använda exempelbilderna "unstitched" från GitHub.

Använda API:et för sömmar

Stitching-API:et kombinerar flera bilder av samma fysiska hylla.

Tre foton av hyllor, bredvid deras kombinerade sammansatta foto.

Kommentar

Varumärkena som visas i bilderna är inte kopplade till Microsoft och anger inte någon form av godkännande av Microsoft- eller Microsoft-produkter av varumärkesägarna, eller ett godkännande av varumärkesägarna eller deras produkter av Microsoft.

Följ dessa steg om du vill köra bildsyrningsåtgärden på en uppsättning bilder:

Ladda upp de bilder som du vill sammanfoga till bloblagringscontainern och hämta den absoluta URL:en för varje bild. Du kan sy upp till 10 bilder samtidigt.

Kopiera följande curl kommando till en textredigerare.

curl.exe -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -H "Content-Type: application/json" "<endpoint>/computervision/imagecomposition:stitch?api-version=2023-04-01-preview" --output <your_filename> -d "{
    'images': [
        '<your_url_string_>',
        '<your_url_string_2>',
        ...
    ]
}"

Gör följande ändringar i kommandot där det behövs:
1. Ersätt värdet <subscriptionKey> för med din visionsresursnyckel.
2. Ersätt värdet <endpoint> för med slutpunkten för visionsresursen. Exempel: https://YourResourceName.cognitiveservices.azure.com.
3. Ersätt innehållet <your_url_string> med blob-URL:erna för bilderna. Bilderna ska sorteras från vänster till höger och uppifrån och ned, enligt de fysiska utrymmen som de visar.
4. Ersätt <your_filename> med namnet och tillägget för filen där du vill få resultatet (till exempel download.jpg).
Öppna ett kommandotolksfönster.
Klistra in det redigerade curl kommandot från textredigeraren i kommandotolken och kör sedan kommandot.

Granska svar på stygn

API:et returnerar ett 200 svar och den nya filen laddas ned till den plats som du angav.

Använda API:et för rättelse

När du har slutfört syåtgärden rekommenderar vi att du utför korrigeringsåtgärden för optimala analysresultat.

Foton på en butikshylla, före och efter åtgärden åtgärdas.

Kommentar

Följ dessa steg för att korrigera perspektivförvrängningen i den sammansatta bilden:

Ladda upp avbildningen som du vill korrigera till bloblagringscontainern och hämta den absoluta URL:en.

Kopiera följande curl kommando till en textredigerare.

curl.exe -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -H "Content-Type: application/json" "<endpoint>/computervision/imagecomposition:rectify?api-version=2023-04-01-preview" --output <your_filename> -d "{
  'url': '<your_url_string>',
  'controlPoints': {
    'topLeft': {
      'x': 0.1,
      'y': 0.1
    },
    'topRight': {
      'x': 0.2,
      'y': 0.2
    },
    'bottomLeft': {
      'x': 0.3,
      'y': 0.3
    },
    'bottomRight': {
      'x': 0.4,
      'y': 0.4
    }
  }
}"

Gör följande ändringar i kommandot där det behövs:
1. Ersätt värdet <subscriptionKey> för med din visionsresursnyckel.
2. Ersätt värdet <endpoint> för med slutpunkten för visionsresursen. Exempel: https://YourResourceName.cognitiveservices.azure.com.
3. Ersätt <your_url_string> med bloblagrings-URL:en för avbildningen.
4. Ersätt de fyra kontrollpunktkoordinaterna i begärandetexten. X är den vågräta koordinaten och Y är lodrät. Koordinaterna normaliseras, så 0,5,0,5 anger mitten av bilden och 1,1 anger till exempel det nedre högra hörnet. Ange koordinaterna för att definiera de fyra hörnen i hyllfixturen så som den visas i bilden.
5. Ersätt <your_filename> med namnet och tillägget för filen där du vill få resultatet (till exempel download.jpg).
Öppna ett kommandotolksfönster.
Klistra in det redigerade curl kommandot från textredigeraren i kommandotolken och kör sedan kommandot.