Vector Tile Service-export in ArcGIS Runtime 100.2

AlexanderErbe

<\/HEAD>

Kaarten bestaan doorgaans uit Basemap Layers voor oriëntatie en Operational Layers voor het visualiseren, opvragen, bewerken en analyseren van geo-informatie. In ArcGIS worden twee typen Basemaps<\/A> onderscheiden: Raster Tile Services (gecachete Map Services en Image Services) en de nog vrij jonge Vector Tile Services.<\/P>

<\/P>

<\/P>

     

Link naar Live Map<\/A><\/P>

<\/P>

<\/DIV>

Voor offline gebruik van Basemaps in

ArcGIS Runtime<\/A> kunnen al geruime tijd Tile Packages (.tpk) direct uit Raster Tile Services geëxporteerd worden. Heel nieuw is nu de mogelijkheid om gebieden van Vector Tile Services te exporteren en lokaal als Vector Tile Packages (.vtpk) te gebruiken:<\/DIV>

<\/P>

Vector Tile Services voor export<\/H3>
Het grote voordeel van Vector Tile Services is het client-side dynamische renderen van tiles. Hierdoor is de Basemap in elke schaal van de kaart en bij elke resolutie van het scherm altijd haarscherp. Verder worden de data en de stijl van de Basemap gescheiden behandeld. Dit maakt dynamisch weergeven van labels mogelijk en het maken van Basemaps met verschillende thema's gebaseerd op steeds dezelfde dataset. En uiteindelijk worden vectoren overgedragen, dus geen afbeeldingen zoals bij Raster Tile Services. Dit zorgt voor hoge performance en aanzienlijk kleinere datavolumes.<\/DIV>
In ArcGIS Online <\/A>worden al een aantal exporteerbare Vector Tile Basemaps aangeboden. De hier gelinkte services<\/A> zijn allemaal gebaseerd op dezelfde World Basemap data, maar telkens met een andere stijl. Als meerdere van deze Basemaps offline gebruikt moeten worden, hoeft alleen van één<\/SPAN> van de services het vtpk (data + "Root Style") en van alle services alleen de stijl geëxporteerd te worden. Hierover later meer.<\/DIV>
Er kunnen ook eigen Vector Tile Services op ArcGIS Online gemaakt en voor export vrijgegeven worden. Hiervoor wordt in de algemene instellingen van het Vector Tile Service Portal Item op het tabblad Instellingen<\/EM> de offline-modus geactiveerd:<\/DIV><\/P><\/DIV><\/P>Hoe eigen Vector Tile Services gemaakt kunnen worden en daarvoor verschillende stijlen gecreëerd kunnen worden, wordt in deze twee Esri UK - blogs heel goed beschreven:<\/P><\/P>Vector Tiles Deel 1 - Creatie<\/A><\/LI>Vector Tiles Deel 2 - Styling<\/A><\/LI><\/UL>

<\/P>

Export van Vector Tile Packages en stijlen in ArcGIS Runtime<\/H3>Voor het exporteren van Vector Tile Services en stijlen zijn de PortalItem IDs<\/A> van de services, een identiteit (Named User of ArcGIS Online Developer Account<\/A>) en minimaal ArcGIS Runtime versie 100.2 nodig. Hier is de voorbeeldprocedure aan de hand van het ArcGIS Runtime SDK for .NET:<\/P>

<\/P>

<\/P>

      Online kaart met het te exporteren gebied (AreaOfInterest in ExportVectorTilesParameters)<\/EM>

1. Authenticeren<\H5>Anonieme export is niet toegestaan, authenticatie is vereist. Hiervoor zijn meerdere mogelijkheden, bijvoorbeeld in deze Sample<\A>.<\P>\n

\n

2. Vector Tile Service PortalItem aanmaken<\H5>\nWe gebruiken in ons codevoorbeeld de World Topographic Map (for Export)<\A>. Hiervan is de Portal ID nodig.<\P>\n

\n

var portal = await ArcGISPortal.CreateAsync();\nvar portalItem = await PortalItem.CreateAsync(portal, \"df541726b3df4c0caf99255bb1be4c86\");‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍<SPAN class=\"line-numbers-rows\"><SPAN‍</SPAN><SPAN‍</SPAN><SPAN‍</SPAN></SPAN>

\n

\n

TIP:\n\nHet is helaas niet mogelijk om van een Vector Tile Service equivalente services met andere stijlen op te vragen. Om dit toch te automatiseren kan in ArcGIS Runtime gezocht worden naar PortalItems-types en tags. \n\nBijvoorbeeld is in de hier beschreven ArcGIS Online Basemaps de specifieke tag \"World_Basemap_Export_v2\". \n\nBij eigen services moet dus een eigen specifieke tag gekozen worden.\n\nZo wordt gezocht:<\PRE>\nvar queryExpression = string.Format(\"tags:\\\\  id="toc-hId--384247244" id="toc-hId--384247244">3. Taak, Parameter en Job aanmaken en uitvoeren</H5><P>In de volgende code worden alleen de gegevens (.vtpk) en niet de Style geëxporteerd.</P><PRE class="lia-code-sample line-numbers language-none"><CODE><SPAN class="comment token">// Maak de taak aan</SPAN>
<SPAN class="keyword token">var</SPAN> exportTask <SPAN class="operator token">=</SPAN> <SPAN class="keyword token">await</SPAN> ExportVectorTilesTask.<SPAN class="token function">CreateAsync</SPAN>(portalItem)<SPAN class="punctuation token">;</SPAN>

<SPAN class="comment token">// Maak een nieuwe parameters instantie aan</SPAN>
<SPAN class="keyword token">var</SPAN> parameters <SPAN class="operator token">=</SPAN> <SPAN class="keyword token">new</SPAN> <SPAN class="token class-name">ExportVectorTilesParameters</SPAN>()
<SPAN class="punctuation token">{
&nbsp;&nbsp;&nbsp; AreaOfInterest = exportArea.Geometry,   // gebied om te exporteren
&nbsp;&nbsp;&nbsp; MaxLevel = exportTask.VectorTileSourceInfo.LevelsOfDetail.Count - 1  // niveaus om te exporteren
}</SPAN><SPAN class="punctuation token">;</SPAN>

<SPAN class="comment token">// Maak de export job aan</SPAN>
<SPAN class="keyword token">var</SPAN> job <SPAN class="operator token">=</SPAN> exportTask.<SPAN class="token function">ExportVectorTiles</SPAN>(parameters, Path.<SPAN class="token function">Combine</SPAN>(_vectorTileCachePath, "name.vtpk"));

<SPAN class="comment token">// Abonneer op meldingen voor statusupdates</SPAN>
job.JobChanged += (sender, e) =>
{

&nbsp;&nbsp; if (job.Status == Esri.ArcGISRuntime.Tasks.JobStatus.Succeeded)
&nbsp;&nbsp; {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; // doe iets
&nbsp;&nbsp; }
&nbsp;&nbsp; else if (job.Status == Esri.ArcGISRuntime.Tasks.JobStatus.Failed)
&nbsp;&nbsp; {
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; // Informeer de gebruiker
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ShowStatusMessage(job.Error.Message);
&nbsp;&nbsp; }
};

<SPAN class="comment token">// Start de export job</SPAN>
job.<SPAN class="token function">Start</SPAN>();‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍<SPAN class="line-numbers-rows"><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</SPAN><SPAN>‍</Span... (truncated) ...  als alleen de Style geëxporteerd moet worden ziet het er zo uit:<\/P><PRE class="lia-code-sample line-numbers language-none"><CODE><SPAN class="keyword token">var<\/SPAN> exportTask <SPAN class="operator token">=<\/SPAN> <SPAN class="keyword token">await<\/SPAN> ExportVectorTilesTask<SPAN class="punctuation token">.<\/SPAN><SPAN class="token function">CreateAsync<\/SPAN><SPAN class="punctuation token">(<\/SPAN>portalItem<SPAN class="punctuation token">)<\/SPAN><SPAN class="punctuation token">;<\/SPAN>
<SPAN class="keyword token">if<\/SPAN> <SPAN class="punctuation token">(<\/SPAN>exportTask<SPAN class="punctuation token">.<\/SPAN>HasStyleResources<SPAN class="punctuation token">)<\/SPAN>
<SPAN class="punctuation token">{<\/SPAN>
&nbsp;&nbsp; <SPAN class="keyword token">var<\/SPAN> exportStyleJob <SPAN class="operator token">=<\/SPAN> exportTask<SPAN class="punctuation token">.<\/SPAN><SPAN class="token function">ExportStyleResourceCache<\/SPAN><SPAN class="punctuation token">(<\/SPAN>_styleResourcePath<SPAN class="punctuation token">)<\/SPAN><SPAN class="punctuation token">;<\/SPAN>
&nbsp;&nbsp; <SPAN class="keyword token">var<\/SPAN> result <SPAN class="operator token">=<\/SPAN> <SPAN class="keyword token">await<\/SPAN> exportStyleJob<SPAN class="punctuation token">.<\/SPAN><SPAN class="token function">GetResultAsync<\/SPAN><SPAN class="punctuation token">(<\/SPAN><SPAN class="punctuation token">)<\/SPAN><SPAN class="punctuation token">;<\/SPAN>
&nbsp;&nbsp; <SPAN class="comment token">\/\/doe iets<\/SPAN>
<SPAN class="punctuation token">}<\/SPAN>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍<SPAN class="line-numbers-rows"><SPAN>‍<\/SPAN><SPAN>‍<\/SPAN><SPAN>‍<\/SPAN><SPAN>‍<\/SPAN><SPAN>‍<\/SPAN><SPAN>‍<\/SPAN><SPAN>‍<\/SPAN><\/span><\/CODE><\/PRE><P><\/P><P>Als bijvoorbeeld alle hierboven beschreven <A href="http:\/\/www.arcgis.com\/home\/search.html?q=vector%20tile%20v2%20for%20export%20world%20basemap&t=content&focus=layers&start=1&sortOrder=desc&sortField=relevance" rel="nofollow noopener noreferrer" target="_blank">exporteerbare ArcGIS Online Vector Tile Services<\/A>&nbsp;lokaal als Basemaps beschikbaar moeten zijn, moet van <U>één<\/U> Service de vtpk en van alle Services alleen de Styles geëxporteerd worden. In een StyleResource map bevinden zich alleen JSON-bestanden met de beschrijving van de Styles, deze zijn erg klein.<\/P><P><\/P><P><IMG class="image-16 jive-image" src="https:\/\/us.v-cdn.net\/6038851\/uploads\/legacyfs\/online\/396344_pastedImage_1.png" style="width: 620px; height: 341px;" \/><\/P><H3 id="toc-hId-1751590101" id="toc-hId-1751590101"><\/H3><H3 id="toc-hId--800566860" id="toc-hId--800566860">Gebruik van lokale Vector Tile Packages en Styles in ArcGIS Runtime<\/H3><P>Het lokale vtpk en een bestaande Style kunnen dan zo in de Map worden geïntegreerd:<\/P><P><\/P><PRE class="lia-code-sample line-numbers language-none"><CODE><SPAN class="comment token">\/ Load een style<\/span>
<Span class = "keyword token ">var <\ / span > itemResourceCache <Span Class = "operator Token "> = <\ / span > <Span Class = "keyword Token "> new <\ / span > <Span Class = "token Class-name "> ItemResourceCache <\ / span ><Span Class = "punctuation Token ">(</span > _styleResourcePath <Span Class = "punctuation Token ") ; </span > << EMOJI_8 >>

<span Class = "comment Token "> \/ Load de vtpk <\ / span >
<span Class = "keyword Token "> var <\ / span > offlineVectorTileCache <Span Class = "operator Token "> = <\ / span > <Span Class = "keyword Token "> new <\ / span > <Span Class = "token Class-name "> VectorTileCache <\ / span ><Span Class = "punctuation Token ">(</span > Path <Span Class = "punctuation Token ".</span ><Span Class = "token Function "> Combine <\ / span ><Span Class = "punctuation Token ">(</span > _vectorTileCachePath ,  <span Class = "string Token "> "name.vtpk" </span ><Span Class = "punctuation Token ") ) ; </span > << EMOJI_9 >>

<span Class = "comment Token "> \/ Maak een tile layer met de cache en de style <\ / span >
<span Class = "keyword Token "> var <\ / span > layer <Span Class = "operator Token "> = <\ / span > <Span Class = "keyword Token "> new <\ / span > <Span Class = "token Class-name "> ArcGISVectorTiledLayer <\ / span ><Span Class = "punctuation Token ">(</span > offlineVectorTileCache ,  itemResourceCache<span Class = "punctuation Token ") ; </span >

<span Class = "comment Token "> \/ Maak een tile layer alleen met de cache <\ / span >
<span Class = "comment Token "> \/ var layer = new ArcGISVectorTiledLayer(offlineVectorTileCache); <\ / span >

<span Class = "comment Token "> \/ Maak een nieuwe map met de layer als basemap <\ / span >
<span Class = "keyword Token "> var <\ / span > map  <span Class = "operator Token ">=</span >  <span Class = "keyword Token ">new</span >  <span Class = "token Class-name ">Map</span ><span Class = "punctuation Token ">(</span ><span Class = "keyword Token ">new</span >  <span Class = "token Class-name ">Basemap</span ><span Class = "punctuation Token ">(</span >layer<span Class = "punctuation Token ") ) ; </span >

<span Class = "comment Token "> \ Pas de map toe op de mapview </span>
MyMapView.Map  <span Class = "operator Token ">=</span > map‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Als de ontwikkelaar alles mooi combineert, kunnen er in de ArcGIS Runtime App lokaal meerdere Basemaps op basis van slechts één vtpk worden gebruikt. Over het opslaggeheugen van de gegevens op het apparaat hoeft meestal ook geen zorg meer te worden gedragen. In een test met het gebied grofweg Beieren in volledige detail is de grootte van het vtpk + Styles slechts ongeveer 230 MB en duurde de export bijna 7 minuten. Belangrijk is ook de informatie dat er een maximale limiet ("maxExportTilesCount":10000) voor een export bestaat.<\/P>

   Offline Vector Tile Basemap zonder extra Style (alleen het .vtpk geladen)

    Offline Vector Tile Basemap met Style

      Offline Vector Tile Basemap met Style

      Offline Vector Tile Basemap met Style

      Offline Vector Tile Basemap met Style

AlexanderErbe

Hey Max,

Das wird uns im SDK geschenkt :

SketchEditor Class 

Und da muss man einen SketchCreationMode setzen, da ist Freehand mit dabei:

SketchCreationMode Enumeration