Je eerste geocoding API call in 5 minuten

# Stap 1: Token aanvragen (eenmalig, geldig voor 10 minuten)
curl -X POST -H "X-API-Key: gx_live_your_key" \
  "https://api.georex.nl/api/token"
# Response: {"token": "grx_...", "expires_in": 600}

# Stap 2: Geocoding request met token
curl "https://api.georex.nl/geocode?q=Damrak+1+Amsterdam&token=YOUR_TOKEN"

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [4.8910, 52.3738]
    },
    "properties": {
      "osm_id": 123456789,
      "osm_type": "N",
      "name": "Damrak 1",
      "street": "Damrak",
      "housenumber": "1",
      "postcode": "1012 LG",
      "city": "Amsterdam",
      "state": "Noord-Holland",
      "country": "Nederland",
      "countrycode": "NL",
      "type": "house"
    }
  }]
}

// Stap 1: Token ophalen (server-side, houdt API key geheim)
async function getToken(apiKey) {
  const response = await fetch('https://api.georex.nl/api/token', {
    method: 'POST',
    headers: { 'X-API-Key': apiKey }
  });
  const data = await response.json();
  return data.token; // Geldig voor 10 minuten
}

// Stap 2: Geocoding met token
async function geocodeAddress(address, token) {
  const query = encodeURIComponent(address);
  const response = await fetch(
    `https://api.georex.nl/geocode?q=${query}&token=${token}`
  );
  const data = await response.json();

  if (data.features && data.features.length > 0) {
    const [lon, lat] = data.features[0].geometry.coordinates;
    console.log(`Coördinaten: ${lat}, ${lon}`);
    return data.features[0];
  }
  throw new Error('Adres niet gevonden');
}

// Gebruik
const token = await getToken('gx_live_your_key');
const result = await geocodeAddress('Damrak 1, Amsterdam', token);
console.log(result.properties);

import requests

def get_token(api_key: str) -> str:
    """Haal een API token op (geldig voor 10 minuten)."""
    response = requests.post(
        'https://api.georex.nl/api/token',
        headers={'X-API-Key': api_key}
    )
    return response.json()['token']

def geocode_address(address: str, token: str) -> dict:
    """Geocodeer een adres naar coördinaten."""
    response = requests.get(
        'https://api.georex.nl/geocode',
        params={'q': address, 'token': token}
    )
    data = response.json()

    if data['features']:
        feature = data['features'][0]
        lon, lat = feature['geometry']['coordinates']
        return {'lat': lat, 'lon': lon, 'properties': feature['properties']}
    raise Exception('Adres niet gevonden')

# Gebruik
if __name__ == '__main__':
    API_KEY = 'gx_live_your_key'
    token = get_token(API_KEY)
    result = geocode_address('Damrak 1, Amsterdam', token)
    print(f"Coördinaten: {result['lat']}, {result['lon']}")

<?php

function getToken(string $apiKey): string
{
    $ch = curl_init('https://api.georex.nl/api/token');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey]
    ]);
    $data = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $data['token']; // Geldig voor 10 minuten
}

function geocodeAddress(string $address, string $token): array
{
    $url = 'https://api.georex.nl/geocode?' . http_build_query([
        'q' => $address,
        'token' => $token
    ]);

    $response = file_get_contents($url);
    $data = json_decode($response, true);

    if (!empty($data['features'])) {
        $feature = $data['features'][0];
        [$lon, $lat] = $feature['geometry']['coordinates'];
        return ['lat' => $lat, 'lon' => $lon, 'properties' => $feature['properties']];
    }
    throw new Exception('Adres niet gevonden');
}

// Gebruik
$apiKey = 'gx_live_your_key';
$token = getToken($apiKey);
$result = geocodeAddress('Damrak 1, Amsterdam', $token);
echo "Coördinaten: {$result['lat']}, {$result['lon']}";