NAiOS IconNAiOS Logo
Volver al catálogo

Graphhopper

graphhopper

GraphHopper Directions API provides enterprise-grade routing services, including route planning, optimization, geocoding, and more, for various vehicle types.

Acciones
8
Triggers
0
Autenticación
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (8)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Capacity ClusteringGRAPHHOPPER_CLUSTER_POSTAcción

Tool to solve capacity clustering problem. Use when assigning a set of customers to clusters to minimize total distance synchronously.

Parámetros de entrada

  • clustersobject[]

    Explicit cluster definitions (optional).

  • customersobject[]Obligatorio

    List of customers to assign to clusters.

  • configurationobjectObligatorio

    Routing and clustering settings.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

GraphHopper GeocodingGRAPHHOPPER_GEOCODE_GETAcción

Tool to perform forward or reverse geocoding. Use when converting between textual addresses and latitude/longitude coordinates.

Parámetros de entrada

  • qstring

    Text to geocode (forward geocoding). Required when reverse=false; must be omitted if reverse=true.

  • keystringObligatorio

    Your GraphHopper API key

  • bboxstring

    Bounding box 'minLon,minLat,maxLon,maxLat'. Requires reverse=false. Only provider=default.

  • zoomnumber

    Map-like zoom level controlling focus radius. Only provider=default.

  • debugboolean

    Pretty-print the output. Default false.

  • limitinteger

    Maximum number of results. Default 5.

  • pointstring

    Coordinate 'lat,lon'. Required when reverse=true; for forward geocoding, acts as location bias.

  • boundsstring

    Bounds 'minLon,minLat,maxLon,maxLat'. For nominatim or opencagedata.

  • localestringenum

    Locale of results. Default 'en'.

    endefr
  • radiusnumber

    Search radius. Default: km for provider=default when reverse=true; meters for provider=gisgraphy.

  • osm_tagstring[]

    OSM tags to filter/include or exclude, e.g., 'tourism:museum' or '!tourism:museum'. Only provider=default.

  • reverseboolean

    Set to true for reverse geocoding. Default false.

  • providerstringenum

    Alternative geocoding provider.

    defaultnominatimgisgraphyopencagedata
  • countrycodestring

    ISO 3166-1 alpha-2 country filter. For nominatim, gisgraphy, or opencagedata.

  • autocompleteboolean

    Enable autocomplete (only for provider=gisgraphy and reverse=false).

  • location_bias_scalenumber

    Location bias scale between 0.0 and 1.0. Only provider=default.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get IsochroneGRAPHHOPPER_ISOCHRONE_GETAcción

Tool to compute isochrone polygons for a given point. Use when you need to determine areas reachable within time or distance constraints.

Parámetros de entrada

  • pointstringObligatorio

    Start location as 'lat,lon', e.g., '52.529407,13.397634'

  • bucketsinteger

    Number of isochrone buckets (optional)

  • profilestring

    Routing profile, e.g., 'car', 'bike', 'foot'

  • time_limitinteger

    Travel time limit in seconds (optional)

  • reverse_flowboolean

    Compute reverse flow if true

  • distance_limitinteger

    Travel distance limit in meters (optional)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Calculate MatrixGRAPHHOPPER_MATRIX_POSTAcción

Tool to calculate distance, time, or weight matrices via POST. Use when you have multiple origins/destinations or a symmetric point set and need a single batch request.

Parámetros de entrada

  • pointsarray[]

    Coordinates for symmetric matrix as [longitude, latitude].

  • profilestringObligatorio

    Routing profile ID (e.g. 'car', 'bike', 'foot').

  • curbsidesstring[]

    Curbside per point ('any','left','right') for symmetrical.

  • fail_fastboolean

    If false, return null for unreachable entries and include hints.

  • to_pointsarray[]

    Destination coordinates as [longitude, latitude]. Provide with from_points.

  • out_arraysstring[]Obligatorio

    Which matrices to include.

  • from_pointsarray[]

    Origin coordinates as [longitude, latitude]. Provide with to_points.

  • point_hintsstring[]

    Hint per point for snapping preference (symmetrical).

  • to_curbsidesstring[]

    Curbside per destination ('any','left','right').

  • from_curbsidesstring[]

    Curbside per origin ('any','left','right').

  • to_point_hintsstring[]

    Hint per destination for snapping preference.

  • from_point_hintsstring[]

    Hint per origin for snapping preference.

  • snap_preventionsstring[]

    Feature types to avoid for snapping (e.g. 'toll', 'ferry').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Custom ProfilesGRAPHHOPPER_PROFILES_GETAcción

Tool to retrieve a list of all user-defined routing profiles. Use when you need to list custom profiles.

Parámetros de entrada

  • keystringObligatorio

    GraphHopper API key for authentication

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

POST RouteGRAPHHOPPER_ROUTE_POSTAcción

Tool to calculate complex routes via POST /route. Use when you need advanced route planning with custom parameters.

Parámetros de entrada

  • debugboolean

    Enable formatted debug output

  • localestring

    Locale for turn instructions

  • pointsarray[]Obligatorio

    Ordered list of [lon, lat] pairs for route waypoints; at least two points required

  • detailsstring[]

    List of path detail keys (e.g., 'street_name','surface','max_speed')

  • profilestringObligatorio

    Vehicle profile (e.g., 'car', 'bike', 'foot')

  • headingsinteger[]

    Preferred headings in degrees; requires ch.disable=true

  • optimizeboolean

    Reorder points to minimize travel time

  • algorithmstringenum

    Special routing mode; requires ch.disable=true

    round_tripalternative_route
  • curbsidesstring[]

    Curbside to approach/leave each point

  • elevationboolean

    Include altitude in geometry

  • ch.disableboolean

    Enable flexible mode for custom_model and advanced options

  • round_tripobject

    Parameters for round trip; requires algorithm='round_trip'

  • calc_pointsboolean

    Include full route geometry

  • point_hintsstring[]

    Optional street hints; one per point

  • custom_modelobject

    Custom routing rules; requires ch.disable=true

  • instructionsboolean

    Include turn-by-turn instructions

  • pass_throughboolean

    Avoid u-turns at via points; requires ch.disable=true

  • points_encodedboolean

    Use polyline encoding for geometry

  • heading_penaltyinteger

    Penalty (s) for deviating from heading; requires ch.disable=true

  • snap_preventionsstring[]

    Road types to avoid during snapping

  • alternative_routeobject

    Parameters for alternative routes; requires algorithm='alternative_route'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Upload GPX FileGRAPHHOPPER_UPLOAD_GPX_FILEAcción

Tool to upload a GPX file to a public file hosting endpoint. Returns a public URL which can be used where a 's3key' is required.

Parámetros de entrada

  • fileobjectObligatorio

    GPX file with name and base64-encoded content

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

GraphHopper VRP POSTGRAPHHOPPER_VRP_POSTAcción

Tool to initiate VRP optimization. Use when you need to solve vehicle routing problems synchronously.

Parámetros de entrada

  • servicesobject[]

    One-location service orders (pickup/delivery stops)

  • vehiclesobject[]Obligatorio

    List of at least one vehicle definition

  • algorithmobject

    Deprecated – use `objectives` instead (legacy algorithms)

  • relationsobject[]

    Custom relationships (e.g., same-route grouping)

  • shipmentsobject[]

    Two-location shipments with pickup and delivery

  • objectivesobject[]

    Objective functions to minimize

  • configurationobject

    Routing and optimization configuration

  • cost_matricesobject[]

    Custom time/distance matrices

  • vehicle_typesobject[]

    Definitions of vehicle types assignable via type_id

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not