Geoapify
geoapifyGeoapify offers a suite of APIs for integrating maps, geocoding, routing, and other location-based services into applications.
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ónTool to fetch address suggestions based on partial input. Use when you need to get predictive suggestions from incomplete address text.
GEOAPIFY_ADDRESS_AUTOCOMPLETEAcciónTool to fetch address suggestions based on partial input. Use when you need to get predictive suggestions from incomplete address text.
Parámetros de entrada
biasstringBias 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
langstringLanguage code (ISO 639-1, 2 letters, e.g., 'en')
textstringObligatorioPartial address text to autocomplete
typestringenumRestrict suggestions by location type
countrystatecitypostcodestreetamenitylocalitylimitintegerMaximum number of results to return, must be >= 1
filterstringFilter results by boundary or country using formats: circle:lon,lat,radius|rect:lon1,lat1,lon2,lat2|countrycode:CC|place:placeId; combine with '|' for AND
formatstringenumResponse format; one of: 'geojson' (default), 'json', 'xml'
geojsonjsonxml
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Batch RequestsGEOAPIFY_BATCH_REQUESTSAcciónTool to create or retrieve batch jobs. Use when processing multiple API calls asynchronously in one operation.
GEOAPIFY_BATCH_REQUESTSAcciónTool to create or retrieve batch jobs. Use when processing multiple API calls asynchronously in one operation.
Parámetros de entrada
idstringBatch job ID. Provide to retrieve status and results; omit to create a new job.
apistringenumAPI path to call. Supported values: /v1/geocode/search, /v1/geocode/reverse, /v1/routing, /v1/isoline.
/v1/geocode/search/v1/geocode/reverse/v1/routing/v1/isolinebodyobjectCommon JSON body for all inputs, e.g., routing mode.
inputsobject[]Array of input objects; up to 1000 elements when creating a job.
paramsobjectCommon query parameters for all inputs, e.g., language code.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Administrative BoundariesGEOAPIFY_BOUNDARIESAcciónTool 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.
GEOAPIFY_BOUNDARIESAcciónTool 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
idstringPlace ID from Geometry or Places API. Mutually exclusive with lat and lon.
latnumberLatitude of the location. Required with lon if id is omitted.
lonnumberLongitude of the location. Required with lat if id is omitted.
langstringLanguage code for results (ISO 639-1).
geometrystringenumLevel of geometry detail to return.
pointgeometry_1000geometry_5000geometry_10000boundariesstringenumType of boundary to retrieve.
administrativepostal_codepoliticallow_emission_zone
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Forward GeocodingGEOAPIFY_FORWARD_GEOCODINGAcciónTool to convert an address into geographic coordinates. Use when you need latitude and longitude from an address.
GEOAPIFY_FORWARD_GEOCODINGAcciónTool to convert an address into geographic coordinates. Use when you need latitude and longitude from an address.
Parámetros de entrada
biasstringLocation 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.
citystringCity name for structured address search
langstringResult language (ISO 639-1 2-letter code, e.g., 'en')
namestringAmenity or place name for structured address search
textstringFree-form address to search, e.g., 'Berlin, Germany'
typestringenumLocation type filter. Allowed: country, state, city, postcode, street, amenity, locality
countrystatecitypostcodestreetamenitylocalitylimitintegerMaximum number of results to return (default 5)
statestringState or province for structured address search
apiKeystringObligatorioGeoapify API key
filterstringLocation filters. Formats: 'circle:lon,lat,radiusMeters', 'rect:lon1,lat1,lon2,lat2', 'countrycode:code1,code2', 'place:placeId'. Combine multiple with '|' for AND logic.
formatstringenumResponse format. One of: geojson (default), json, xml
geojsonjsonxmlstreetstringStreet name for structured address search
countrystringCountry name for structured address search
postcodestringPostal code or ZIP for structured address search
housenumberstringHouse number for structured address search
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Geometry OperationGEOAPIFY_GEOMETRYAcciónTool to perform geometric operations on stored polygon geometries. Use when combining or intersecting multiple stored geometries.
GEOAPIFY_GEOMETRYAcciónTool to perform geometric operations on stored polygon geometries. Use when combining or intersecting multiple stored geometries.
Parámetros de entrada
idstring[]ObligatorioList of at least two geometry IDs to combine or intersect.
operationstringObligatorioenumGeometric operation to apply. Must be 'union' or 'intersection'.
unionintersection
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
IP GeolocationGEOAPIFY_IP_GEOLOCATIONAcciónTool to determine geographic location of an IP address. Use when you need to lookup location information by IP.
GEOAPIFY_IP_GEOLOCATIONAcciónTool to determine geographic location of an IP address. Use when you need to lookup location information by IP.
Parámetros de entrada
ipstringIP address to lookup; if omitted, uses the caller's IP.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Generate isoline (isochrone/isodistance)GEOAPIFY_ISOLINEAcciónTool to generate isochrone or isodistance isolines. Use when visualizing reachable areas from a point; use `id` to poll ongoing calculations.
GEOAPIFY_ISOLINEAcciónTool to generate isochrone or isodistance isolines. Use when visualizing reachable areas from a point; use `id` to poll ongoing calculations.
Parámetros de entrada
idstringUnique identifier of previously generated isoline (valid 24h). Exclusive with lat/lon/type/mode/range.
latnumberLatitude of the origin point in decimal degrees. Required for new calculation.
lonnumberLongitude of the origin point in decimal degrees. Required for new calculation.
modestringenumTravel mode for route calculation. Required for new calculation.
drivelight_truckmedium_trucktruckheavy_trucktruck_dangerous_goodslong_truckbusscootermotorcyclebicyclemountain_bike+5typestringenumIsoline type: 'time' (seconds) or 'distance' (meters). Required for new calculation.
timedistanceavoidstringAvoid rules separated by '|', e.g. tolls or ferries.
rangeintegerIsoline range(s): seconds for time or meters for distance. Supply single int or list for multiple.
unitsstringenumUnits for distance calculations. Default metric.
metricimperialtrafficstringenumTraffic model (motorized modes only). Default free_flow.
free_flowapproximatedmax_speedintegerVehicle max speed in KPH (10-252). Applies to drive/truck/bus modes.
route_typestringenumRoute optimization. Default balanced.
balancedshortless_maneuvers
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Map MatchingGEOAPIFY_MAP_MATCHINGAcciónTool to snap GPS traces to the road network and correct inaccuracies. Use when raw GPS points need alignment to roads.
GEOAPIFY_MAP_MATCHINGAcciónTool to snap GPS traces to the road network and correct inaccuracies. Use when raw GPS points need alignment to roads.
Parámetros de entrada
modestringObligatorioenumTravel mode: drive, walk, or bicycle
drivewalkbicycleapiKeystringObligatorioGeoapify API key
waypointsobject[]ObligatorioList of GPS waypoints to match (1 to 1000 points)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch Geoapify Map TilesGEOAPIFY_MAP_TILESAcciónTool to fetch raster map tiles or style JSON from Geoapify. Use when rendering custom maps with specific styles.
GEOAPIFY_MAP_TILESAcciónTool to fetch raster map tiles or style JSON from Geoapify. Use when rendering custom maps with specific styles.
Parámetros de entrada
xintegerTile column X (required when mode='tile').
yintegerTile row Y (required when mode='tile').
zintegerZoom level (required when mode='tile').
modestringenumChoose 'tile' to fetch a raster PNG tile, or 'style' to fetch the style JSON.
tilestylestylestringObligatorioMap style ID. E.g., 'osm-bright', 'positron', 'dark-matter'.
apiKeystringObligatorioYour Geoapify API key.
retinabooleanWhether to request high-DPI '@2x' tile (only when mode='tile').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create Marker IconGEOAPIFY_MARKER_ICONAcciónTool to create custom map marker icons. Use when you need a tailored marker after defining map annotations.
GEOAPIFY_MARKER_ICONAcciónTool to create custom map marker icons. Use when you need a tailored marker after defining map annotations.
Parámetros de entrada
iconstringInner icon name per the selected library.
sizeintegerTotal icon image height in pixels.
textstringText to display instead of an icon.
typestringenumMarker style/shape. Defaults to 'material' if not specified.
materialawesomecircleplaincolorstringBackground color; ignored for type='plain'; must be URL-encoded, '#' as '%23'.
iconTypestringenumIcon library; defaults to match 'type'.
materialawesomenoShadowbooleanFlag to disable default shadow.
contentSizeintegerInner icon/text height in pixels.
shadowColorstringShadow color; must be URL-encoded, '#' as '%23'.
strokeColorstringBorder color; ignored for type='plain'; must be URL-encoded, '#' as '%23'.
contentColorstringColor of inner icon/text; must be URL-encoded, '#' as '%23'.
noWhiteCirclebooleanFlag to remove the white circle.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Place DetailsGEOAPIFY_PLACE_DETAILSAcciónTool to retrieve detailed information about a specific place. Use when you have a place ID or coordinates and need comprehensive metadata.
GEOAPIFY_PLACE_DETAILSAcciónTool 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
idstringPlace unique identifier returned by Geoapify Places or Geocoding API. Required if `lat` and `lon` are not provided.
latnumberLatitude of the place. Must be provided together with `lon` if `id` is omitted.
lonnumberLongitude of the place. Must be provided together with `lat` if `id` is omitted.
langstringResponse language (ISO 639-1 code, two lowercase letters).
featuresstringComma-separated list of features to return. Defaults to `details` when request is by `id`.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Places SearchGEOAPIFY_PLACESAcciónTool to search for points of interest within a specified area. Use when you need POIs matching categories after defining spatial filter or bias.
GEOAPIFY_PLACESAcciónTool 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
biasstringProximity bias toward a location: 'proximity:lon,lat'.
langstringResponse language code (ISO 639-1), e.g., 'en'.
namestringReturn only places matching this name.
limitintegerMaximum number of results per page. Must be >= 1.
filterstringSpatial 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).
offsetintegerStart index for pagination; use with limit. Must be >= 0.
categoriesstring[]ObligatorioPrimary place category keys (comma-separated).
conditionsstring[]Additional filters such as accessibility/amenities (comma-separated).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Postcode SearchGEOAPIFY_POSTCODEAcciónTool to retrieve postcode information for a location. Use when you need to fetch postcode details based on a given postcode or geographic coordinates.
GEOAPIFY_POSTCODEAcciónTool 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
latnumberLatitude of location; must be provided with lon
lonnumberLongitude of location; must be provided with lat
langstringResponse language (ISO 639-1 code, 2 letters)
formatstringenumResponse format; one of: 'json', 'geojson', 'xml'
geojsonjsonxmlgeometrystringenumReturn geometry as 'point' or 'original' boundary
pointoriginalpostcodestringPostal code to search for
countrycodestringRestrict search to country (ISO 3166-1 alpha-2)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Reverse GeocodingGEOAPIFY_REVERSE_GEOCODINGAcciónTool to reverse geocode coordinates into a structured address. Use when converting lat/lon to human-readable addresses.
GEOAPIFY_REVERSE_GEOCODINGAcciónTool to reverse geocode coordinates into a structured address. Use when converting lat/lon to human-readable addresses.
Parámetros de entrada
latnumberObligatorioLatitude coordinate in decimal degrees.
lonnumberObligatorioLongitude coordinate in decimal degrees.
langstring2-letter ISO 639-1 language code for the result.
typestringenumAddress level to search; one of country, state, city, postcode, street, amenity.
countrystatecitypostcodestreetamenitylimitintegerMaximum number of results to return (default: 1).
formatstringenumResponse format: one of geojson, json, xml (default: geojson).
geojsonjsonxml
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Route MatrixGEOAPIFY_ROUTE_MATRIXAcciónTool to compute travel time and distance matrices. Use when you need durations and distances between multiple origin and destination pairs.
GEOAPIFY_ROUTE_MATRIXAcciónTool to compute travel time and distance matrices. Use when you need durations and distances between multiple origin and destination pairs.
Parámetros de entrada
modestringTravel mode; see Routing API Travel Modes
typestringenumRoute type; default 'balanced'
balancedshortless_maneuversavoidstring[]Road types or areas to avoid (see Routing API avoid options)
unitsstringenumUnits for distance; default 'metric'
metricimperialapiKeystringObligatorioGeoapify API key
sourcesobject[]List of origin waypoints
targetsobject[]List of destination waypoints
trafficstringenumTraffic model; motorized modes only; default 'free_flow'
free_flowapproximatedmax_speednumberMaximum vehicle speed in KPH (10-252)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Route PlannerGEOAPIFY_ROUTE_PLANNERAcciónTool to optimize multi-agent routes and schedules. Use after defining agents and jobs/shipments.
GEOAPIFY_ROUTE_PLANNERAcciónTool to optimize multi-agent routes and schedules. Use after defining agents and jobs/shipments.
Parámetros de entrada
jobsobject[]One-way jobs to assign
modestringTravel mode (e.g., drive, bicycle, walk)
typestringenumRoute optimization preference
balancedshortless_maneuversavoidobject[]Avoid rules objects as per Route Planner API
unitsstringenumDistance units
metricimperialagentsobject[]List of agents (vehicles/workers)
trafficstringenumTraffic model
free_flowapproximatedlocationsobject[]Reusable locations for indexing
max_speednumberMax speed km/h for driving modes
shipmentsobject[]Paired pickups/deliveries to assign
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
RoutingGEOAPIFY_ROUTINGAcciónTool to calculate routes between multiple waypoints. Use when you need both distance, time, and turn-by-turn directions for two or more coordinates.
GEOAPIFY_ROUTINGAcciónTool 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
langstringenumLanguage code for instructions (e.g., en, de, fr).
bgcacsdadeelen-GBenesetfifr+16modestringenumTravel mode (default: drive).
drivelight_truckmedium_trucktruckheavy_trucktruck_dangerous_goodslong_truckbusscootermotorcyclebicyclemountain_bike+5typestringenumRoute optimization: balanced (default), short, less_maneuvers. (less_maneuvers only for motorized road modes)
balancedshortless_maneuversavoidstringAvoid options separated by '|', e.g., 'tolls|ferries:0.5|highways'.
unitsstringenumDistance units; metric (default) or imperial.
metricimperialformatstringenumResponse format: geojson (default), json, xml.
geojsonjsonxmldetailsstringComma-separated extra details: instruction_details, route_details, elevation.
trafficstringenumTraffic model for motorized modes (default: free_flow).
free_flowapproximatedmax_speedintegerMax vehicle speed in KPH (10-252).
waypointsstringObligatorioTwo 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
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not