Bestanden uploaden

Grid Statistics 1.0

Gebruik onderstaand URL-sjabloon om bestanden met puntwaarnemingen te uploaden.

Ondersteunde HTTP-methoden

POST

URL-sjabloon

Bestand met puntwaarnemingen uploaden naar uw documentbibliotheek.

http://api.gisblox.com/REST/v1/gridstatistics/manage/upload?file=filename&skipHeader=skipHeader&format=format&key=PersoonlijkeGISBloxSleutel

Parameters

Opmerking

Parameternamen en -waarden zijn niet hoofdlettergevoelig.

Parameter	Omschrijving	Waarde
file	Vereist De bestandsnaam van het bronbestand (zonder bestandslocatie).	Toegestane bestandstypen zijn tekstbestanden (.txt / .dat) en Excel-bestanden (versies 97...2010). Elk bestand dient slechts drie (aaneensluitende) kolommen te bevatten: Kolom A (Excel) of eerste kolom (tekstbestand): X-coördinaat volgens het Rijksdriehoeksstelsel (RdNew) Kolom B (Excel) of tweede kolom (tekstbestand): Y-coördinaat volgens het Rijksdriehoeksstelsel (RdNew) Kolom C (Excel) of derde kolom (tekstbestand): de meetwaarde, bijvoorbeeld de WOZ-waarde. Tekstbestanden dienen puntkomma-gescheiden te zijn. Het bronbestand mag maximaal 10 MB groot zijn. Voorbeeld: file=enquete2012.xlsx
skipHeader	Optioneel Eerste regel van het bronbestand overslaan.	Geeft aan of de eerste regel van het bronbestand moet worden overgeslagen tijdens het inlezen. Zet deze parameter op true indien het bestand kolomkoppen bevat. Eén van de volgende opties: false [standaardwaarde] true Voorbeeld: skipHeader=true
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

Input

Plaats de inhoud van het bronbestand in de body van het HTTP-verzoek om de data te uploaden. Stel tevens de volgende request headers in:

Content-Length: de grootte van de data in het bronbestand in bytes.
Content-Type: één van de volgende waarden:
- Tekst-bestand (text/plain)
- Excel-bestand (application/vnd.ms-excel)

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 onderstaand voorbeeld is een leeg Response-object. Voor informatie over de algemene types en parameters kijkt u op de Algemene types en parameters-pagina.

Voorbeeld

Een bronbestand uploaden

In onderstaand voorbeeld ziet u de URL waarmee bronbestand 'enquete2012.xlsx' wordt geüpload. De eerste regel van het bestand wordt niet overgeslagen bij het inlezen.

http://api.gisblox.com/REST/v1/gridstatistics/manage/upload?file=enquete2012.xlsx&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 BartelsOnline. 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 BartelsOnline.</Copyright>
	<StatusCode>200</StatusCode>
	<StatusDescription>OK</StatusDescription>
	<ErrorDetails/>
	<TraceId>8FF19DAE-A073-40B8-BEF0-51070CAB9E86/d4972bfb-8d3e-458f-892c-60745a5dbba4/1186938526</TraceId>
	<Resource i:type="DataFileUpload">
		<ItemId>1</ItemId>
		<Name>enquete2012</Name>
		<Created>2013-12-05T11:11:19.5518436+01:00</Created>
		<Completed>2013-12-05T11:11:20.0468719+01:00</Completed>		
		<Status>Completed</Status>
	</Resource>
</Response>

JSON Response

                    
{
	"Copyright": "Copyright © 2011-2017 BartelsOnline. 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 BartelsOnline.",
	"StatusCode": 200,
	"StatusDescription": "OK",
	"ErrorDetails": "",
	"TraceId": "8FF19DAE-A073-40B8-BEF0-51070CAB9E86/d4972bfb-8d3e-458f-892c-60745a5dbba4/1186938526",
	"Resource":	{
		"__type": "DataFileUpload:http:\/\/schemas.gisblox.com\/rest\/v1\/gridstatistics",
		"ItemId": 1,
		"Name": "enquete2012",
		"Created": "\/Date(1354703135947+0100)\/",
		"Completed": "\/Date(1354703136207+0100)\/",		
		"Status": "Completed"		
	}
}

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

Beheer-API Bestanden verwijderen

Laatst gewijzigd: 2018-10-18