NAiOS IconNAiOS Logo
Volver al catálogo

Geoapify

geoapify

Geoapify offers a suite of APIs for integrating maps, geocoding, routing, and other location-based services into applications.

Acciones
17
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 (17)

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.

Address AutocompleteGEOAPIFY_ADDRESS_AUTOCOMPLETEAcción

Tool to fetch address suggestions based on partial input. Use when you need to get predictive suggestions from incomplete address text.

Parámetros de entrada

  • biasstring

    Bias results by proximity or boundary using formats: proximity:lon,lat|circle:lon,lat,radius|rect:lon1,lat1,lon2,lat2|countrycode:CC; combine with '|' for OR

  • langstring

    Language code (ISO 639-1, 2 letters, e.g., 'en')

  • textstringObligatorio

    Partial address text to autocomplete

  • typestringenum

    Restrict suggestions by location type

    countrystatecitypostcodestreetamenitylocality
  • limitinteger

    Maximum number of results to return, must be >= 1

  • filterstring

    Filter results by boundary or country using formats: circle:lon,lat,radius|rect:lon1,lat1,lon2,lat2|countrycode:CC|place:placeId; combine with '|' for AND

  • formatstringenum

    Response format; one of: 'geojson' (default), 'json', 'xml'

    geojsonjsonxml

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

Batch RequestsGEOAPIFY_BATCH_REQUESTSAcción

Tool to create or retrieve batch jobs. Use when processing multiple API calls asynchronously in one operation.

Parámetros de entrada

  • idstring

    Batch job ID. Provide to retrieve status and results; omit to create a new job.

  • apistringenum

    API path to call. Supported values: /v1/geocode/search, /v1/geocode/reverse, /v1/routing, /v1/isoline.

    /v1/geocode/search/v1/geocode/reverse/v1/routing/v1/isoline
  • bodyobject

    Common JSON body for all inputs, e.g., routing mode.

  • inputsobject[]

    Array of input objects; up to 1000 elements when creating a job.

  • paramsobject

    Common query parameters for all inputs, e.g., language code.

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 Administrative BoundariesGEOAPIFY_BOUNDARIESAcción

Tool to retrieve administrative boundaries a location is part of. Use when you have either a place ID or coordinates and need GeoJSON boundaries. Returns a FeatureCollection.

Parámetros de entrada

  • idstring

    Place ID from Geometry or Places API. Mutually exclusive with lat and lon.

  • latnumber

    Latitude of the location. Required with lon if id is omitted.

  • lonnumber

    Longitude of the location. Required with lat if id is omitted.

  • langstring

    Language code for results (ISO 639-1).

  • geometrystringenum

    Level of geometry detail to return.

    pointgeometry_1000geometry_5000geometry_10000
  • boundariesstringenum

    Type of boundary to retrieve.

    administrativepostal_codepoliticallow_emission_zone

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

Forward GeocodingGEOAPIFY_FORWARD_GEOCODINGAcción

Tool to convert an address into geographic coordinates. Use when you need latitude and longitude from an address.

Parámetros de entrada

  • biasstring

    Location bias. Formats: 'circle:lon,lat,radiusMeters', 'rect:lon1,lat1,lon2,lat2', 'countrycode:code1,code2', 'proximity:lon,lat'. Combine multiple with '|' for OR logic. Default is countrycode:auto.

  • citystring

    City name for structured address search

  • langstring

    Result language (ISO 639-1 2-letter code, e.g., 'en')

  • namestring

    Amenity or place name for structured address search

  • textstring

    Free-form address to search, e.g., 'Berlin, Germany'

  • typestringenum

    Location type filter. Allowed: country, state, city, postcode, street, amenity, locality

    countrystatecitypostcodestreetamenitylocality
  • limitinteger

    Maximum number of results to return (default 5)

  • statestring

    State or province for structured address search

  • apiKeystringObligatorio

    Geoapify API key

  • filterstring

    Location filters. Formats: 'circle:lon,lat,radiusMeters', 'rect:lon1,lat1,lon2,lat2', 'countrycode:code1,code2', 'place:placeId'. Combine multiple with '|' for AND logic.

  • formatstringenum

    Response format. One of: geojson (default), json, xml

    geojsonjsonxml
  • streetstring

    Street name for structured address search

  • countrystring

    Country name for structured address search

  • postcodestring

    Postal code or ZIP for structured address search

  • housenumberstring

    House number for structured address search

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

Geometry OperationGEOAPIFY_GEOMETRYAcción

Tool to perform geometric operations on stored polygon geometries. Use when combining or intersecting multiple stored geometries.

Parámetros de entrada

  • idstring[]Obligatorio

    List of at least two geometry IDs to combine or intersect.

  • operationstringObligatorioenum

    Geometric operation to apply. Must be 'union' or 'intersection'.

    unionintersection

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

IP GeolocationGEOAPIFY_IP_GEOLOCATIONAcción

Tool to determine geographic location of an IP address. Use when you need to lookup location information by IP.

Parámetros de entrada

  • ipstring

    IP address to lookup; if omitted, uses the caller's IP.

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

Generate isoline (isochrone/isodistance)GEOAPIFY_ISOLINEAcción

Tool to generate isochrone or isodistance isolines. Use when visualizing reachable areas from a point; use `id` to poll ongoing calculations.

Parámetros de entrada

  • idstring

    Unique identifier of previously generated isoline (valid 24h). Exclusive with lat/lon/type/mode/range.

  • latnumber

    Latitude of the origin point in decimal degrees. Required for new calculation.

  • lonnumber

    Longitude of the origin point in decimal degrees. Required for new calculation.

  • modestringenum

    Travel mode for route calculation. Required for new calculation.

    drivelight_truckmedium_trucktruckheavy_trucktruck_dangerous_goodslong_truckbusscootermotorcyclebicyclemountain_bike+5
  • typestringenum

    Isoline type: 'time' (seconds) or 'distance' (meters). Required for new calculation.

    timedistance
  • avoidstring

    Avoid rules separated by '|', e.g. tolls or ferries.

  • rangeinteger

    Isoline range(s): seconds for time or meters for distance. Supply single int or list for multiple.

  • unitsstringenum

    Units for distance calculations. Default metric.

    metricimperial
  • trafficstringenum

    Traffic model (motorized modes only). Default free_flow.

    free_flowapproximated
  • max_speedinteger

    Vehicle max speed in KPH (10-252). Applies to drive/truck/bus modes.

  • route_typestringenum

    Route optimization. Default balanced.

    balancedshortless_maneuvers

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

Map MatchingGEOAPIFY_MAP_MATCHINGAcción

Tool to snap GPS traces to the road network and correct inaccuracies. Use when raw GPS points need alignment to roads.

Parámetros de entrada

  • modestringObligatorioenum

    Travel mode: drive, walk, or bicycle

    drivewalkbicycle
  • apiKeystringObligatorio

    Geoapify API key

  • waypointsobject[]Obligatorio

    List of GPS waypoints to match (1 to 1000 points)

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

Fetch Geoapify Map TilesGEOAPIFY_MAP_TILESAcción

Tool to fetch raster map tiles or style JSON from Geoapify. Use when rendering custom maps with specific styles.

Parámetros de entrada

  • xinteger

    Tile column X (required when mode='tile').

  • yinteger

    Tile row Y (required when mode='tile').

  • zinteger

    Zoom level (required when mode='tile').

  • modestringenum

    Choose 'tile' to fetch a raster PNG tile, or 'style' to fetch the style JSON.

    tilestyle
  • stylestringObligatorio

    Map style ID. E.g., 'osm-bright', 'positron', 'dark-matter'.

  • apiKeystringObligatorio

    Your Geoapify API key.

  • retinaboolean

    Whether to request high-DPI '@2x' tile (only when mode='tile').

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

Create Marker IconGEOAPIFY_MARKER_ICONAcción

Tool to create custom map marker icons. Use when you need a tailored marker after defining map annotations.

Parámetros de entrada

  • iconstring

    Inner icon name per the selected library.

  • sizeinteger

    Total icon image height in pixels.

  • textstring

    Text to display instead of an icon.

  • typestringenum

    Marker style/shape. Defaults to 'material' if not specified.

    materialawesomecircleplain
  • colorstring

    Background color; ignored for type='plain'; must be URL-encoded, '#' as '%23'.

  • iconTypestringenum

    Icon library; defaults to match 'type'.

    materialawesome
  • noShadowboolean

    Flag to disable default shadow.

  • contentSizeinteger

    Inner icon/text height in pixels.

  • shadowColorstring

    Shadow color; must be URL-encoded, '#' as '%23'.

  • strokeColorstring

    Border color; ignored for type='plain'; must be URL-encoded, '#' as '%23'.

  • contentColorstring

    Color of inner icon/text; must be URL-encoded, '#' as '%23'.

  • noWhiteCircleboolean

    Flag to remove the white circle.

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

Place DetailsGEOAPIFY_PLACE_DETAILSAcción

Tool to retrieve detailed information about a specific place. Use when you have a place ID or coordinates and need comprehensive metadata.

Parámetros de entrada

  • idstring

    Place unique identifier returned by Geoapify Places or Geocoding API. Required if `lat` and `lon` are not provided.

  • latnumber

    Latitude of the place. Must be provided together with `lon` if `id` is omitted.

  • lonnumber

    Longitude of the place. Must be provided together with `lat` if `id` is omitted.

  • langstring

    Response language (ISO 639-1 code, two lowercase letters).

  • featuresstring

    Comma-separated list of features to return. Defaults to `details` when request is by `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

Places SearchGEOAPIFY_PLACESAcción

Tool to search for points of interest within a specified area. Use when you need POIs matching categories after defining spatial filter or bias.

Parámetros de entrada

  • biasstring

    Proximity bias toward a location: 'proximity:lon,lat'.

  • langstring

    Response language code (ISO 639-1), e.g., 'en'.

  • namestring

    Return only places matching this name.

  • limitinteger

    Maximum number of results per page. Must be >= 1.

  • filterstring

    Spatial filter to constrain the search area. Formats: 'circle:lon,lat,radiusMeters', 'rect:lon1,lat1,lon2,lat2', 'geometry:geometryId', 'place:placeId', 'countrycode:code1,code2' (coming soon).

  • offsetinteger

    Start index for pagination; use with limit. Must be >= 0.

  • categoriesstring[]Obligatorio

    Primary place category keys (comma-separated).

  • conditionsstring[]

    Additional filters such as accessibility/amenities (comma-separated).

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

Postcode SearchGEOAPIFY_POSTCODEAcción

Tool to retrieve postcode information for a location. Use when you need to fetch postcode details based on a given postcode or geographic coordinates.

Parámetros de entrada

  • latnumber

    Latitude of location; must be provided with lon

  • lonnumber

    Longitude of location; must be provided with lat

  • langstring

    Response language (ISO 639-1 code, 2 letters)

  • formatstringenum

    Response format; one of: 'json', 'geojson', 'xml'

    geojsonjsonxml
  • geometrystringenum

    Return geometry as 'point' or 'original' boundary

    pointoriginal
  • postcodestring

    Postal code to search for

  • countrycodestring

    Restrict search to country (ISO 3166-1 alpha-2)

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

Reverse GeocodingGEOAPIFY_REVERSE_GEOCODINGAcción

Tool to reverse geocode coordinates into a structured address. Use when converting lat/lon to human-readable addresses.

Parámetros de entrada

  • latnumberObligatorio

    Latitude coordinate in decimal degrees.

  • lonnumberObligatorio

    Longitude coordinate in decimal degrees.

  • langstring

    2-letter ISO 639-1 language code for the result.

  • typestringenum

    Address level to search; one of country, state, city, postcode, street, amenity.

    countrystatecitypostcodestreetamenity
  • limitinteger

    Maximum number of results to return (default: 1).

  • formatstringenum

    Response format: one of geojson, json, xml (default: geojson).

    geojsonjsonxml

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

Route MatrixGEOAPIFY_ROUTE_MATRIXAcción

Tool to compute travel time and distance matrices. Use when you need durations and distances between multiple origin and destination pairs.

Parámetros de entrada

  • modestring

    Travel mode; see Routing API Travel Modes

  • typestringenum

    Route type; default 'balanced'

    balancedshortless_maneuvers
  • avoidstring[]

    Road types or areas to avoid (see Routing API avoid options)

  • unitsstringenum

    Units for distance; default 'metric'

    metricimperial
  • apiKeystringObligatorio

    Geoapify API key

  • sourcesobject[]

    List of origin waypoints

  • targetsobject[]

    List of destination waypoints

  • trafficstringenum

    Traffic model; motorized modes only; default 'free_flow'

    free_flowapproximated
  • max_speednumber

    Maximum vehicle speed in KPH (10-252)

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

Route PlannerGEOAPIFY_ROUTE_PLANNERAcción

Tool to optimize multi-agent routes and schedules. Use after defining agents and jobs/shipments.

Parámetros de entrada

  • jobsobject[]

    One-way jobs to assign

  • modestring

    Travel mode (e.g., drive, bicycle, walk)

  • typestringenum

    Route optimization preference

    balancedshortless_maneuvers
  • avoidobject[]

    Avoid rules objects as per Route Planner API

  • unitsstringenum

    Distance units

    metricimperial
  • agentsobject[]

    List of agents (vehicles/workers)

  • trafficstringenum

    Traffic model

    free_flowapproximated
  • locationsobject[]

    Reusable locations for indexing

  • max_speednumber

    Max speed km/h for driving modes

  • shipmentsobject[]

    Paired pickups/deliveries to assign

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

RoutingGEOAPIFY_ROUTINGAcción

Tool to calculate routes between multiple waypoints. Use when you need both distance, time, and turn-by-turn directions for two or more coordinates.

Parámetros de entrada

  • langstringenum

    Language code for instructions (e.g., en, de, fr).

    bgcacsdadeelen-GBenesetfifr+16
  • modestringenum

    Travel mode (default: drive).

    drivelight_truckmedium_trucktruckheavy_trucktruck_dangerous_goodslong_truckbusscootermotorcyclebicyclemountain_bike+5
  • typestringenum

    Route optimization: balanced (default), short, less_maneuvers. (less_maneuvers only for motorized road modes)

    balancedshortless_maneuvers
  • avoidstring

    Avoid options separated by '|', e.g., 'tolls|ferries:0.5|highways'.

  • unitsstringenum

    Distance units; metric (default) or imperial.

    metricimperial
  • formatstringenum

    Response format: geojson (default), json, xml.

    geojsonjsonxml
  • detailsstring

    Comma-separated extra details: instruction_details, route_details, elevation.

  • trafficstringenum

    Traffic model for motorized modes (default: free_flow).

    free_flowapproximated
  • max_speedinteger

    Max vehicle speed in KPH (10-252).

  • waypointsstringObligatorio

    Two or more waypoints in 'lat,lon' or 'lonlat:lon,lat' format, pipe-separated. E.g. '36.734770,-76.610637|36.761226,-76.488354'

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