Skip to content

Locatie & geo

Publieke GraphQL-queries: Locatie & geo.

Endpoint: POST https://graphql.persmonitor.nl/graphql


cities

Zoek Nederlandse woonplaatsen (City) op naam/gemeente; min. 2 tekens. Bij gelijknamige plaatsen (Heusden) toont displayName de gemeente; filter bij voorkeur op uuid.

Return type: [City!]!

Authenticatie: Geen login vereist

Argumenten:

ArgumentTypeVerplichtBeschrijving
searchString!JaZoekterm (min. 2 tekens).
firstIntNee (default: 20)Max. aantal resultaten (1–50).

Voorbeeld:

graphql
query Cities(
  $first: Int
) {
  cities(search: $search, first: $first) {
    # selecteer velden uit het return type
  }
}

locationSuggestions

Zoek Nederlandse plaatsen, adressen of postcodes (PDOK); min. 2 tekens. Geeft coördinaten terug voor straalfilters.

Return type: [LocationSuggestion!]!

Authenticatie: Geen login vereist

Argumenten:

ArgumentTypeVerplichtBeschrijving
searchString!JaZoekterm (min. 2 tekens), bijv. Utrecht, Oudegracht 100 of 3511.
firstIntNee (default: 10)Max. aantal resultaten (1–20).

Voorbeeld:

graphql
query LocationSuggestions(
  $first: Int
) {
  locationSuggestions(search: $search, first: $first) {
    # selecteer velden uit het return type
  }
}

nlProvinces

NL-provincies uit Neo4j Province-nodes (gevuld via CBS woonplaatsen-sync).

Return type: [NlProvince!]!

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

graphql
query NlProvinces {
  nlProvinces {
    # selecteer velden uit het return type
  }
}

nlProvincesGeoJson

GeoJSON FeatureCollection van de 12 Nederlandse provincies. Voor KNMI-kaart in de monitor. Null als bestand nog niet gesynct is (voer nl-provinces:sync-geojson uit).

Return type: String

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

graphql
query NlProvincesGeoJson {
  nlProvincesGeoJson {
    # selecteer velden uit het return type
  }
}

postcodes

Zoek Nederlandse postcodes op code; min. 2 tekens.

Return type: [Postcode!]!

Authenticatie: Geen login vereist

Argumenten:

ArgumentTypeVerplichtBeschrijving
searchString!JaZoekterm (min. 2 tekens, bijv. 3511 of 3511AB).
firstIntNee (default: 20)Max. aantal resultaten (1–50).

Voorbeeld:

graphql
query Postcodes(
  $first: Int
) {
  postcodes(search: $search, first: $first) {
    # selecteer velden uit het return type
  }
}