Wegen & hectometers

Publieke GraphQL-queries: Wegen & hectometers.

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

---

availableHectometers

Distinct hectometer values for a road (for 112hub dropdown).

Return type: [Float!]

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
road	RoadRef!	Ja	Weg-selectie, bijv. { name: "A12" }.

Voorbeeld:

query AvailableHectometers {
  availableHectometers(road: $road) {
    # selecteer velden uit het return type
  }
}

---

hectometerMarker

Fetch one hectometer marker by UUID.

Return type: HectometerMarker

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
marker	HectometerMarkerRef!	Ja	Marker-selectie, bijv. { uuid }.

Voorbeeld:

query HectometerMarker {
  hectometerMarker(marker: $marker) {
    # selecteer velden uit het return type
  }
}

---

hectometerMarkers

Hectometer-markers: filter + paginatie.

Return type: [HectometerMarker]

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
first	Int	Nee (default: 50)	Het aantal resultaten per pagina (default 50; globale read-cap 100, tenzij de query een hogere cap documenteert).
page	Int	Nee (default: 1)	De pagina die je wilt opvragen.
filter	HectometerMarkerFilterInput	Nee	Index-filters (weg, hectometer, zijde).

Voorbeeld:

query HectometerMarkers(
  $first: Int
  $page: Int
  $filter: HectometerMarkerFilterInput
) {
  hectometerMarkers(first: $first, page: $page, filter: $filter) {
    # selecteer velden uit het return type
  }
}

---

hectometerMarkersNearest

Nearest hectometer markers to a lat/lon (e.g. for 112hub "dichtstbijzijnde paaltje"). Each marker includes distance_km.

Return type: [HectometerMarker]

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
lat	Float!	Ja	Latitude (WGS84).
lon	Float!	Ja	Longitude (WGS84).
limit	Int	Nee (default: 10)	Max number of markers to return (default 10, max 50).

Voorbeeld:

query HectometerMarkersNearest(
  $limit: Int
) {
  hectometerMarkersNearest(lat: $lat, lon: $lon, limit: $limit) {
    # selecteer velden uit het return type
  }
}

---

highways

Snelwegen (A-wegen) uit Neo4j Road-nodes, voor matrix/files/accident filters.

Return type: [MonitorReferenceItem!]!

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

query Highways {
  highways {
    # selecteer velden uit het return type
  }
}

---

parseHectometerSearch

Parse free-text hectometer search (e.g. "A12 45.2 links") into road, hectometer and side. For 112hub and other frontends; logic in API for consistency.

Return type: ParseHectometerSearchResult

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
search	String!	Ja	Free-text search (e.g. "A12 45.2 links" or "N201 10.5").

Voorbeeld:

query ParseHectometerSearch {
  parseHectometerSearch(search: $search) {
    # selecteer velden uit het return type
  }
}

---

road

Fetch one road by UUID or name.

Return type: Road

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
road	RoadRef!	Ja	Weg-selectie, bijv. { uuid } of { name }.

Voorbeeld:

query Road {
  road(road: $road) {
    # selecteer velden uit het return type
  }
}

---

roads

Lijst wegen (bijv. A12, N201) met optionele marker-telling; filter + paginatie.

Return type: [Road]

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
first	Int	Nee (default: 50)	Het aantal resultaten per pagina (default 50; globale read-cap 100, tenzij de query een hogere cap documenteert).
page	Int	Nee (default: 1)	De pagina die je wilt opvragen.
filter	RoadFilterInput	Nee	Index-filters (o.a. withMarkerCount).

Voorbeeld:

query Roads(
  $first: Int
  $page: Int
  $filter: RoadFilterInput
) {
  roads(first: $first, page: $page, filter: $filter) {
    # selecteer velden uit het return type
  }
}

---

roadsGroupedByPrefix

Roads grouped by prefix (A, N, S, R) for dropdowns (e.g. 112hub).

Return type: RoadsGroupedByPrefix

Authenticatie: Geen login vereist

Geen argumenten.

Voorbeeld:

query RoadsGroupedByPrefix {
  roadsGroupedByPrefix {
    # selecteer velden uit het return type
  }
}

---

searchRoads

Zoek wegen op naam (A12, N201, …) voor autocomplete; min. 1 teken.

Return type: [Road!]!

Authenticatie: Geen login vereist

Argumenten:

Argument	Type	Verplicht	Beschrijving
search	String!	Ja	Zoekterm (bijv. A12 of 12).
first	Int	Nee (default: 20)	Max. aantal resultaten (1–50).

Voorbeeld:

query SearchRoads(
  $first: Int
) {
  searchRoads(search: $search, first: $first) {
    # selecteer velden uit het return type
  }
}

---