Gebruik onderstaande URL-sjablonen om op basis van de IDW-methode vierkantstatistieken te berekenen (of op te vragen) en deze als rastershapefile te downloaden.
Een rastershapefile wordt gegenereerd als ESRI Shapefile.
Ondersteunde HTTP-methoden
GET
URL-sjablonen
Bereken eenmalig een vierkantstatistiek en vraag deze als rastershapefile op
http://api.gisblox.com/REST/v1/gridstatistics/idw/getshapefile?file=file&cellSize=cellSize&distMax=distMax&observMin=observMin&pwr=pwr&format=format&key=PersoonlijkeGISBloxSleutel
Bereken een vierkantstatistiek, sla deze berekening op en vraag het resultaat als rastershapefile op
http://api.gisblox.com/REST/v1/gridstatistics/idw/getshapefile?file=file&calcName=calcName&cellSize=cellSize&distMax=distMax&observMin=observMin&pwr=pwr&format=format&key=PersoonlijkeGISBloxSleutel
Vraag het resultaat van een bestaande berekening als rastershapefile op
http://api.gisblox.com/REST/v1/gridstatistics/idw/getshapefile?calcName=calcName&format=format&key=PersoonlijkeGISBloxSleutel
Sjabloonparameters
Opmerking
Kijk op de
Algemene types en parameters-pagina voor informatie over de algemene respons-types en parameters die deze URL gebruikt.
Parameternamen en -waarden zijn niet hoofdlettergevoelig.
| Parameter |
Omschrijving |
Waarde |
| file |
Optioneel De naam van het bronbestand in uw documentbibliotheek waarvoor een nieuwe calculatie gemaakt moet worden. |
Een string met de bestandsnaam.
Voorbeeld: file=Enquete2012
|
| calcName |
Optioneel De naam van een eerder uitgevoerde calculatie. Indien deze parameter gecombineerd wordt met de file-parameter, dan wordt de uit te voeren calculatie onder deze naam opgeslagen, zodat deze later via de calcName parameter op te vragen is. |
Een string met de calculatienaam.
Voorbeeld: calcName=ResultaatEnquete2012
|
| cellSize |
Vereist Een maat voor de grootte van de vierkanten waarvoor de statistiek wordt berekend. De parameterwaarde staat voor de lengte van één zijde van het vierkant, in gehele meters. Invoer van waarde 100 leidt dus tot een statistiek opgebouwd uit de geometrie van vierkanten van 100 bij 100 meter.
|
Een string met een getal in het waardebereik 25...315.000.
Voorbeeld: cellSize=100
|
| distMax |
Vereist De maximale afstand vanuit het middelpunt van elk vierkant (straal) waarbinnen puntwaarnemingen nog meetellen voor de interpolatieberekening van het betreffende vierkant. |
Een string met een geheel getal in het waardebereik 1...315.000.
Voorbeeld: distMax=10
|
| observMin |
Vereist Het minimaal aantal puntwaarnemingen dat zich binnen de opgegeven straal (distMax) moet bevinden voordat een interpolatieberekening voor het betreffende vierkant wordt berekend. |
Een string met een geheel getal in het waardebereik 0...16.000.000.
Voorbeeld: observMin=5
|
| pwr |
Vereist De macht-waarde voor exponentieel afstandverval. |
Een string met een getal in het waardebereik 0...10.
Voorbeeld: pwr=0.1
|
| format |
Optioneel Het output-formaat van de respons. |
Eén van de volgende opties:
- xml [standaardwaarde]
- json
Voorbeeld: format=json
|
| key |
Vereist Specificeert de GISBlox API-sleutel die voor dit verzoek gebruikt moet worden. |
Een geldige GISBlox API-sleutel.
Voorbeeld: key=abc1234def56789
|
Respons
Als antwoord op een HTTP-verzoek wordt een respons-object geretourneerd. Afhankelijk van de waarde van input-parameter format, heeft het respons-object het volgende output-formaat:
- XML (application/xml)
- JSON (application/json)
Resultaat
Het resultaat van onderstaande voorbeelden wordt geretourneerd als een RasterShapeFile-resource binnen het generieke Response-type. Kijk voor meer informatie over de RasterShapeFile-resource op de pagina over het RasterShapeFile-type.
Voor informatie over de overige algemene types en parameters kijkt u op de Algemene types en parameters-pagina.
Attribuuttabel
De attribuuttabel van de shapefile in het ZIP-bestand van het RasterShapeFileData-element van het RasterShapeFile-type heeft de volgende structuur:
| Attribuut |
Omschrijving |
| C28992R... |
Het cellocatie-coderingsattribuut. Zie voor meer informatie de FieldNameCL-parameter van het CalcResultIDW-type:
Voorbeeld: C28992R50
|
| MaxRange |
De waarde van de distMax-parameter.
Voorbeeld: 100
|
| N |
Het totaal aantal puntwaarnemingen waarop de berekening gebaseerd is.
Voorbeeld: 300
|
| NCell |
Het aantal puntwaarnemingen binnen het vierkant.
Voorbeeld: 65
|
| Z |
De uitkomst van de berekening (aantal, gemiddelde of som). Opmerking: als NCell lager is dan de waarde van de observMin-parameter, maar groter dan nul, dan krijgt Z de waarde -9998.
Als NCell gelijk is aan nul, dan wordt Z -9999.
Voorbeeld: 25
|
Voorbeelden
Bereken eenmalig een vierkantstatistiek op basis van de IDW-methode en vraag deze als rastershapefile op
In onderstaand voorbeeld wordt een rastershapefile gemaakt op basis van de IDW-methode met als bronbestand Enquete2012.
De vierkantsgrootte is ingesteld op 100x100 meter en er moeten zich minimaal 5 puntwaarnemingen binnen het vierkant bevinden.
De maximale straal is 10 meter en het exponentieel afstandverval is ingesteld op 0,1. Het resultaat wordt niet opgeslagen.
http://api.gisblox.com/REST/v1/gridstatistics/idw/getshapefile?file=Enquete2012&cellSize=100&observMin=5&distMax=10&pwr=0.1&key=PersoonlijkeGISBloxSleutel
Bereken een vierkantstatistiek op basis van de IDW-methode, sla de calculatie op en retourneer het resultaat als rastershapefile
In onderstaand voorbeeld wordt een rastershapefile gemaakt op basis van de IDW-methode met als bronbestand Enquete2012 en opgeslagen onder de naam ResultaatEnquete2012.
De vierkantsgrootte is ingesteld op 100x100 meter en er moeten zich minimaal 5 puntwaarnemingen binnen het vierkant bevinden.
De maximale straal is 20 meter en het exponentieel afstandverval wordt niet ingesteld (op nul gesteld).
http://api.gisblox.com/REST/v1/gridstatistics/idw/getshapefile?file=Enquete2012&calcName=ResultaatEnquete2012&cellSize=100&observMin=5&distMax=20&pwr=0&key=PersoonlijkeGISBloxSleutel
Vraag het resultaat van een bestaande IDW-berekening als rastershapefile op
In onderstaand voorbeeld wordt de bestaande IDW-berekening ResultaatEnquete2012 geopend en geretourneerd als rastershapefile.
http://api.gisblox.com/REST/v1/gridstatistics/idw/getshapefile?calcName=ResultaatEnquete2012&key=PersoonlijkeGISBloxSleutel
XML Response
<Response xmlns="http://schemas.gisblox.com/rest/v1/gridstatistics" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Copyright>Copyright © 2011-2017 Bartels Online. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Bartels Online.</Copyright>
<StatusCode>200</StatusCode>
<StatusDescription>OK</StatusDescription>
<ErrorDetails />
<TraceId>8FF19DAE-A073-40B8-BEF0-51070CAB9E86/5b65e036-c71f-4ff9-8458-899ee8d92c95/-1541119371</TraceId>
<Resource i:type="RasterShapeFile">
<ItemId>1</ItemId>
<CalculationJobId>b1859d90-c4f9-499c-b30a-68f393594b15</CalculationJobId>
<CalculationParameters i:type="CalcInputIDW">
<CalculationName>ResultaatEnquete2012</CalculationName>
<CellSize>100</CellSize>
<DataFileName>enquete2012</DataFileName>
<InsufficientValue>-9998</InsufficientValue>
<NoData>-9999</NoData>
<ObservMin>5</ObservMin>
<DistMax>20</DistMax>
<Pwr>0</Pwr>
</CalculationParameters>
<CalculationResult i:type="CalcResultIDW">
<BBoxColMax>179</BBoxColMax>
<BBoxRowMax>159</BBoxRowMax>
<BBoxXLo>83000</BBoxXLo>
<BBoxYLo>429200</BBoxYLo>
<FieldNameCL>C28992R100</FieldNameCL>
<RMPCharge>36</RMPCharge>
<Warnings i:nil="true" />
<ZMax>3.8333333333333335</ZMax>
<ZMin>2.1111111111111112</ZMin>
</CalculationResult>
<MimeType>application/zip</MimeType>
<RasterShapeFileData>UEsDBBQAAAAIAM6BRER4PiV80CUAAGRUAQAXACQAU ...</RasterShapeFileData>
</Resource>
</Response>
JSON Response
{
"Copyright": "Copyright © 2011-2017 Bartels Online. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Bartels Online.",
"StatusCode": 200,
"StatusDescription": "OK",
"ErrorDetails": "",
"TraceId": "8FF19DAE-A073-40B8-BEF0-51070CAB9E86\/f0e97ac7-5ffb-4a87-b409-3be4a1eb1e1c\/1813518042",
"Resource": {
"__type": "RasterShapeFile:http:\/\/schemas.gisblox.com\/rest\/v1\/gridstatistics",
"ItemId": 1,
"CalculationJobId": "b1859d90-c4f9-499c-b30a-68f393594b15",
"CalculationParameters": {
"__type": "CalcInputIDW:http:\/\/schemas.gisblox.com\/rest\/v1\/gridstatistics",
"CalculationName": "ResultaatEnquete2012",
"CellSize": 100,
"DataFileName": "enquete2012",
"InsufficientValue": -9998,
"NoData": -9999,
"ObservMin": 5,
"DistMax": 20,
"Pwr": 0
},
"CalculationResult": {
"__type": "CalcResultIDW:http:\/\/schemas.gisblox.com\/rest\/v1\/gridstatistics",
"BBoxColMax": 179,
"BBoxRowMax": 159,
"BBoxXLo": 83000,
"BBoxYLo": 429200,
"FieldNameCL": "C28992R100",
"RMPCharge": 36,
"Warnings": null,
"ZMax": 3.8333333333333335,
"ZMin": 2.1111111111111112
},
"MimeType": "application\/zip",
"RasterShapeFileData": [80, 75, 3, 4, 20, 0, 0, 0, 8, 0, 224, 129, 68, 68, 120, ...]
}
}
RasterShapeFile
De shapefile wordt in een ZIP-bestand (als byte array) verstuurd. Om het daadwerkelijke ZIP-bestand te genereren, serialiseert u de data in element RasterShapeFileData naar een bestand.
Onderstaand voorbeeldcode in C# dat met behulp van de Write-methode van het System.IO.FileStream-object de data in element RasterShapeFileData schrijft naar een bestand:
string bestandsnaam = @"C:\MijnShapeFile.zip";
using (System.IO.FileStream fs = new System.IO.FileStream(bestandsnaam, System.IO.FileMode.Create, System.IO.FileAccess.Write))
{
byte[] bestandsData = // Methode die de data in element RasterShapeFileData leest
fs.Write(bestandsData, 0, bestandsData.Length);
}
HTTP-statuscodes
Na een succesvol verzoek wordt de volgende HTTP-statuscode geretourneerd.
Na een niet-succesvol verzoek wordt een van de volgende foutcodes geretourneerd.
Verwante onderwerpen
Laatst gewijzigd: 2018-10-18