Rasterbestand genereren (IDW)

Grid Statistics 1.0

Gebruik onderstaande URL-sjablonen om op basis van de IDW-methode vierkantstatistieken te berekenen (of op te vragen) en deze als rasterbestand te downloaden. Een rasterbestand wordt gegenereerd als tekstbestand in ASCII-formaat.

Ondersteunde HTTP-methoden

GET

URL-sjablonen

Bereken eenmalig een vierkantstatistiek en vraag deze als rasterbestand op

http://api.gisblox.com/REST/v1/gridstatistics/idw/getraster?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 rasterbestand op

http://api.gisblox.com/REST/v1/gridstatistics/idw/getraster?file=file&calcName=calcName&cellSize=cellSize&distMax=distMax&observMin=observMin&pwr=pwr&format=format&key=PersoonlijkeGISBloxSleutel

Vraag het resultaat van een bestaande berekening als rasterbestand op

http://api.gisblox.com/REST/v1/gridstatistics/idw/getraster?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.

Raster-type: bevat de berekende uitkomsten van een IDW- of Join-methode als rasterbestand.
CalcInputIDW-type: geeft informatie over invoerparameters.
CalcResultIDW-type: geeft informatie over het berekende resultaat.
Output-parameters: bevat informatie over het output-formaat van de respons.

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 Raster-resource binnen het generieke Response-type. Kijk voor meer informatie over de Raster-resource op de pagina over het Raster-type. Voor informatie over de overige algemene types en parameters kijkt u op de Algemene types en parameters-pagina.

Voorbeelden

Bereken eenmalig een vierkantstatistiek op basis van de IDW-methode en vraag deze als rasterbestand op

In onderstaand voorbeeld wordt een rasterbestand 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/getraster?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 rasterbestand

In onderstaand voorbeeld wordt een rasterbestand 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/getraster?file=Enquete2012&calcName=ResultaatEnquete2012&cellSize=100&observMin=5&distMax=20&pwr=0&key=PersoonlijkeGISBloxSleutel

Vraag het resultaat van een bestaande IDW-berekening als rasterbestand op

In onderstaand voorbeeld wordt de bestaande IDW-berekening ResultaatEnquete2012 geopend en geretourneerd als rasterbestand.

http://api.gisblox.com/REST/v1/gridstatistics/idw/getraster?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/ec6a781f-e152-4a47-9f0e-63706ba9362c/-788179974</TraceId>
  <Resource i:type="Raster">
    <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>593.8333333333333335</ZMax>
      <ZMin>2.1111111111111112</ZMin>
    </CalculationResult>
    <MimeType>text/plain</MimeType>
    <RasterData>bmNvbHMgICAgICAgICAxNzkNCm5yb3dzICAg ...</RasterData>
  </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\/ca339540-2e5e-4489-a27e-43b4ac45f22a\/1102638343",
    "Resource": {
        "__type": "Raster: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": 593.8333333333333335,
            "ZMin": 2.1111111111111112
        },
        "MimeType": "text\/plain",
        "RasterData": [110, 99, 111, 108, 115, 32, 32, 32, 32, 32, 32, 32, 32, 32, 49, 55, ...]
    }
}

Rasterbestand

Om het daadwerkelijke rasterbestand te genereren, serialiseert u de data in element RasterData naar een bestand. Onderstaand een voorbeeld van een rasterbestand dat met behulp van de Write-methode van het System.IO.FileStream-object en de data in element RasterData is gemaakt:

                    
ncols         179
nrows         159
xllcorner     83000
yllcorner     429200
cellsize      100
NODATA_value  -9999
-9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 
-9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9998 -9999 105.235294 106.962963 -9999 -9999 -9999 -9999 -9999 -9999 
-9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 137.821429 198.900000 138.045455 140.226804 137.260163 112.178571 108.429688 163.913580 147.350000 -9999 -9999 -9999 -9999 -9999 -9999 -9999 
-9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 132.470588 203.344828 119.647059 124.240602 154.182796 365.733333 180.719298 165.416667 138.000000 149.223529 125.281250 122.633663 105.298701 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 
-9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 133.838710 137.494624 128.344828 227.558824 188.858586 140.432203 222.254545 170.858974 149.100000 164.155556 204.714286 135.653465 105.112245 126.380952 117.673267 117.333333 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 
-9999 -9999 -9999 -9999 -9999 -9999 121.444444 125.127451 133.123288 131.513043 119.894737 195.024390 174.769231 158.179245 263.882353 180.402439 148.010870 136.950617 140.985075 116.764045 116.421965 106.000000 113.915493 115.211268 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 
-9998 -9999 -9999 -9999 129.925000 122.641509 121.643411 121.213333 122.613139 124.638298 176.307692 233.850000 173.142857 143.835052 164.512195 169.676923 130.144000 118.255319 133.931034 132.761905 115.024000 123.355556 131.586957 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9998 
-9999 134.017857 142.191489 116.135593 119.106509 120.950276 120.166667 102.952703 132.133333 149.406250 289.714286 205.738462 136.088435 143.059259 160.090909 123.423358 120.021127 118.794643 144.524590 146.350000 111.811024 131.145631 133.235294 137.625000 -9999 -9999 -9999 -9999 -9998 -9999 -9998 145.125000 129.537313 
150.367470 131.896296 123.282051 119.623037 125.852601 125.475000 120.644444 115.740000 129.689655 192.363636 159.182609 166.863636 163.145161 107.393939 125.687500 138.043478 128.747253 136.119048 154.164706 146.909091 110.924051 134.493151 143.121622 -9999 -9999 -9999 -9999 -9999 -9999 132.733333 137.733333 166.697368 152.048780 
155.701031 129.520548 112.373984 120.443662 126.546154 122.295082 108.644068 112.378049 151.447368 157.371795 141.163636 139.013514 134.340659 135.597222 142.493151 151.897059 130.139241 112.757282 110.015038 108.539130 141.836364 142.000000 -9999 -9999 -9999 -9999 -9999 -9999 -9999 159.323810 156.419753 154.645455 149.786885 
132.696970 124.064516 138.627451 135.639344 125.686441 134.495798 135.903226 188.622222 168.851852 160.432432 127.740741 129.000000 117.750000 128.562500 139.103896 126.641509 122.040000 119.670886 111.021053 -9999 -9999 -9999 -9998 -9999 -9999 -9999 -9999 -9999 183.888889 156.378378 161.072464 148.968254 138.247312 
158.054545 125.149123 122.645570 145.096386 123.981651 134.953642 157.968750 134.125000 133.529412 187.107143 218.857143 -9998 86.036145 108.041958 117.869565 123.341463 117.702290 109.156627 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 162.515789 158.514851 160.534483 166.692308 161.884211 
...

HTTP-statuscodes

Opmerking

Meer details over deze HTTP-statuscode zijn te vinden in artikel Statuscodes en foutafhandeling.

Na een succesvol verzoek wordt de volgende HTTP-statuscode geretourneerd.

Na een niet-succesvol verzoek wordt een van de volgende foutcodes geretourneerd.

Verwante onderwerpen

IDW-API Rasterbestand genereren (Join) Algemene types en parameters

Laatst gewijzigd: 2018-10-18