Grandix API

Door middel van onze API is het mogelijk om onze data op jouw site te krijgen. De meest simpele manier is het gebruik van de afbeelding, waarmee je binnen enkele tellen de data op je site hebt. Voor de gevorderde gebruikers bieden wij XML bestanden aan.

Inhoud

• Huidige data - Afbeelding
• Huidige data - XML versie
• Gemiddelden afgelopen 24 uur - XML versie
• Foutmeldingen bij het gebruik

Huidige data - Afbeelding

Wil je de data als afbeelding? Voeg dan een afbeelding toe aan je broncode met de HTML-tag <img>. Gebruik als src de volgende locatie: http://api.grandix.nl/?image&amp;akey=JOUW-API-SLEUTEL.

De afbeelding wordt een keer in de 5 minuten opnieuw gegenereerd. Daardoor is het ook mogelijk de afbeelding lokaal te cachen.

Volledige code

<a href="http://www.grandix.nl" target="_blank"><img src="http://api.grandix.nl/?image&amp;akey=JOUW-API-SLEUTEL" alt="Het weer" title="Het weer" width="300" height="180" /></a>

Voorbeeld

Huidige data - XML versie

De data die in bovenstaande afbeelding staat is ook op te vragen in een XML-bestand. Deze data wordt een keer per 5 minuten vernieuwd, gebruik bij voorkeur lokale caching.

Doordat deze XML slechts één meting geeft is het mogelijk om de waarden in een lokale database op te slaan. Daarmee kan een historie opgebouwd worden.

Volledige code

http://api.grandix.nl/?huidig-xml&akey=JOUW-API-SLEUTEL

Voorbeeld

De XML structuur is als volgt:

<weerdata>
   <log>
      <date>2009-04-08</date>
      <time>17:00:00</time>
      <temp_outside>12.7</temp_outside>
      <prediction>
         <![CDATA[De komende uren blijft het overwegend bewolkt
         en wordt het kouder. Er staat veel wind. Binnen 12 uur kan
         er neerslag vallen, mogelijk van betekenis.]]>
      </prediction>
   </log>
</weerdata>

De volgende eenheden moeten voor de waarden aangehouden worden:

• date
  Datum, Engelse notatie
• time
  Tijd, de tijd van het uur, 24 uurs notatie
• temp_outside
  Buitentemperatuur, °C
• prediction
  De voorspelling van het weer, tekst zonder opmaak

Gemiddelden afgelopen 24 uur - XML versie

De data van de laatste 24 uur is op te vragen in XML formaat. Je krijgt dan een overzicht van meetpunten met daarin de temperatuur, de luchtvochtigheid en de windsnelheid. De meetpunten bedragen de gemiddelden over de uren.

Dit is een groot bestand om bij elke aanvraag binnen te halen. Daarnaast wordt het bestand slechts eenmaal per uur ververst. Wij willen daarom graag dat het bestand lokaal op de server gecached wordt.

Volledige code

http://api.grandix.nl/?xml&akey=JOUW-API-SLEUTEL

Voorbeeld

De XML structuur is als volgt:

<weerdata>
   <log>
      <date>2009-04-08</date>
      <time>17:00:00</time>
      <temp_outside>12.7</temp_outside>
      <barometer>1009.4</barometer>
      <wind_speed>12.4</wind_speed>
      <wind_direction>217</wind_direction>
   </log>
   <log>
      ...
   </log>
</weerdata>

Het element log komt meerdere keren voor en kan met een loop doorlopen worden. De volgende eenheden moeten voor de waarden aangehouden worden:

• date
  Datum, Engelse notatie
• time
  Tijd, de tijd van het uur, 24 uurs notatie
• temp_outside
  Gemiddelde buitentemperatuur, °C
• barometer
  Gemiddelde luchtdruk, hPa
• wind_speed
  Gemiddelde windsnelheid, km/h
• wind_direction
  Gemiddelde windrichting, ° (tussen 0 en 360)

Foutmeldingen bij het gebruik

Wat doe je fout bij welke foutmeldingen?

• Geen API sleutel opgegeven
  Er is geen API sleutel met de request meegestuurd.
• Geen geldige API sleutel opgegeven
  Er is een API sleutel gevonden in de request, maar deze API sleutel is niet bekend. Mogelijk is de account inactief gemaakt of verwijderd.
• Ongeldige API sleutel, sleutel is van een ander domein
  De sleutel die meegegeven is behoord bij een ander domein. Maak een sleutel aan voor het huidige domein.
• API sleutel inactief
  Er is een API sleutel gevonden in de request, maar deze API sleutel is (nog) niet actief.