The Geoapify connector lets your AI agent act in each user's Geoapify account. Each user connects their own Geoapify API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 29 tools.
- Tools
- 29
- What they doRead · write · destructive
- 25 · 4 · 025 read4 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Geoapify connection
In AgentKit > Connections, create a Geoapify connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'geoapify'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Geoapify:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'geoapify_boundaries_part_of',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "geoapify"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Geoapify:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="geoapify_boundaries_part_of",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Geoapify credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolgeoapify_batch_geocode_reverse_getGet the status or results of a batch reverse geocoding job.Read-onlyGet Batch Reverse Geocoding Results
Get the status or results of a batch reverse geocoding job. Returns the pending status while running, then one address per input location. Start the job with geoapify_batch_geocode_reverse_create.
Inputs
idstringrequired- Batch job identifier returned by the submit endpoint. Example: 51a5c7bdd1f2a52a40595d1d7a55743b4a40f00103f90146f3.
formatstring- Batch geocode result format. Default: json.one of
jsongeojson
geoapify_batch_geocode_search_getGet the status or results of a batch geocoding job.Read-onlyGet Batch Geocoding Results
Get the status or results of a batch geocoding job. Returns the pending status while running, then one result per input address with lat, lon and formatted address. Start the job with geoapify_batch_geocode_search_create.
Inputs
idstringrequired- Batch job identifier returned by the submit endpoint. Example: 51a5c7bdd1f2a52a40595d1d7a55743b4a40f00103f90146f3.
formatstring- Batch geocode result format. Default: json.one of
jsongeojson
geoapify_batch_getGet the status or results of a generic batch job.Read-onlyGet Batch Job Results
Get the status or results of a generic batch job. Returns the pending status while running, then one result per input with its params and the API response. Start the job with geoapify_batch_create.
Inputs
idstringrequired- Batch job identifier returned by the submit endpoint. Example: 51a5c7bdd1f2a52a40595d1d7a55743b4a40f00103f90146f3.
geoapify_boundaries_consists_ofList the boundaries one level (or more) below a boundary, such as the districts of a city.Read-onlyGet Sub-Boundaries
List the boundaries one level (or more) below a boundary, such as the districts of a city. Returns a feature for each sub-boundary with place_id, name, boundary type and optional geometry. Get the boundary place ID from geoapify_boundaries_part_of or a geocoding result.
Inputs
idstringrequired- Geoapify place identifier returned by the Geocoding, Places, or related Geoapify APIs. This is the recommended lookup method. Example: 51a5c7bdd1f2a52a40595d1d7a55743b4a40f00103f90146f3.
boundarystring- Boundary type to return. Default: administrative.one of
administrativepostal_codepoliticallow_emission_zonepublic_transporttraditionaltimezonereligious_administrationreligiousplaceneighborhoodregionmunicipalitybaronytownhealthhistorichistoric:administrative geometrystring- Geometry representation for returned boundaries. point returns representative points and is the default. The geometry_* values return simplified Polygon or MultiPolygon geometry at the specified accuracy in meters.one of
pointgeometry_1000geometry_5000geometry_10000 langstring- Language used for boundary names and address fields. Default: en.
sublevelinteger- Nested boundary depth. Default: 1.
geoapify_boundaries_part_ofList the administrative and other boundaries (city, county, state, country, postcode) that contain a location or place.Read-onlyGet Boundaries Containing
List the administrative and other boundaries (city, county, state, country, postcode) that contain a location or place. Returns a feature for each containing boundary with name, boundary type, admin level and optional geometry. Use geoapify_boundaries_consists_of for the sub-areas of a boundary.
Inputs
boundariesstring- Boundary types to return. Multiple values are comma-separated. Separate multiple values with ,. Values: administrative, postal_code, political, low_emission_zone, public_transport, traditional, timezone, religious_administration, religious, place, neighborhood, region, municipality, barony, town, health, historic, historic:administrative. Example: administrative,postal_code.
geometrystring- Geometry representation for returned boundaries. point returns representative points and is the default. The geometry_* values return simplified Polygon or MultiPolygon geometry at the specified accuracy in meters.one of
pointgeometry_1000geometry_5000geometry_10000 idstring- Geoapify place identifier returned by the Geocoding, Places, or related Geoapify APIs. This is the recommended lookup method. Example: 51a5c7bdd1f2a52a40595d1d7a55743b4a40f00103f90146f3.
langstring- Language used for boundary names and address fields. Default: en.
latnumber- Latitude of the place. Alternative to id; provide together with lon and leave unset when using a place ID. Example: 52.5163.
lonnumber- Longitude of the place. Alternative to id; provide together with lat and leave unset when using a place ID. Example: 13.3777.
osm_idinteger- Numeric OpenStreetMap object identifier. Alternative to id; use together with osm_type and leave unset when using a place ID. Example: 240109189.
osm_typestring- OpenStreetMap object type used with osm_id: n for node, w for way, or r for relation.one of
rwn
geoapify_elevation_getGet the ground elevation of up to 1,000 locations, optionally with the distance from the previous point.Read-onlyGet Elevation
Get the ground elevation of up to 1,000 locations, optionally with the distance from the previous point. Returns results in input order with elevation in meters or feet. Use for elevation profiles along a route.
Inputs
locationsarrayrequired- Ordered input locations. Use [longitude, latitude] arrays or objects with lat and lon. Results preserve this order. Example: [[13.3777, 52.5163], [13.405, 52.52]].
formatstring- Response representation. json returns a results array; geojson returns a FeatureCollection. Default: json.one of
jsongeojson includeDistanceboolean- When true, include the distance from the previous input location. The first result has distance 0. Default: False. Example: false.
unitsstring- Elevation and optional distance units. Metric results use meters (m); imperial results use rounded feet (ft). Default: metric.one of
metricimperial
geoapify_geocode_autocompleteSuggest addresses and places for partial text, for type-ahead search.Read-onlyAutocomplete Address
Suggest addresses and places for partial text, for type-ahead search. Returns suggestions with formatted address, address parts, lat, lon and result type. Use geoapify_geocode_search for a complete address.
Inputs
textstringrequired- Partial address or place name to autocomplete. Example: Potsdamer Platz, Berlin.
biasstring- Result ranking bias. Separate multiple values with ,. Example: proximity:13.3777,52.5163.
countrycodesstring- ISO 3166-1 alpha-2 country filters. Separate multiple values with ,. Example: de,at.
filterstring- Hard result filters. Separate multiple values with ,. Example: countrycode:de.
formatstring- Response serialization: geojson, json, or xml. Default: geojson.one of
jsongeojson langstring- Result language. Default: en.
limitinteger- Maximum number of results. Example: 20.
typestring- Requested location type. Example: country.one of
countrystatecitypostcodestreetamenitylocality
geoapify_geocode_reverseConvert latitude and longitude into the nearest address or place.Read-onlyReverse Geocode
Convert latitude and longitude into the nearest address or place. Returns the address with formatted text, street, city, postcode, country and distance from the point. Use geoapify_geocode_search for address to coordinates.
Inputs
latnumberrequired- Latitude. Example location: Old Saint Stephens Church, 24 Clark Street, Boston, Massachusetts. Example: 52.5163.
lonnumberrequired- Longitude for the same example location. Example: 13.3777.
countrycodesstring- ISO 3166-1 alpha-2 country filters. Separate multiple values with ,. Example: de,at.
formatstring- Response format. Default: geojson.one of
jsongeojson langstring- Result language. Default: en.
limitinteger- Maximum number of results. Default: 1. Example: 20.
typestring- Requested result type. Example: country.one of
countrystatecitypostcodestreetamenitylocalitybuilding
geoapify_geocode_searchConvert a free-form or structured address into coordinates and a normalized address.Read-onlyGeocode Address
Convert a free-form or structured address into coordinates and a normalized address. Returns matching locations with lat, lon, formatted address, address parts, result type and confidence. Use geoapify_geocode_autocomplete for type-ahead and geoapify_geocode_reverse for coordinates to address.
Inputs
biasstring- Result ranking bias. Separate multiple values with ,. Example: proximity:13.3777,52.5163.
citystring- City name. Structured address input; do not use with text. Example: Berlin.
countrystring- Country name. Structured address input; do not use with text. Example: Germany.
countrycodesstring- ISO 3166-1 alpha-2 country filters. Separate multiple values with ,. Example: de,at.
filterstring- Hard result filters. Separate multiple values with ,. Example: countrycode:de.
formatstring- Response serialization: geojson, json, or xml. Default: geojson.one of
jsongeojson housenumberstring- House number. Structured address input; do not use with text. Example: 1.
langstring- Result language. Default: en.
limitinteger- Maximum number of results. Example: 20.
namestring- Place or amenity name. Structured address input; do not use with text. Example: Brandenburger Tor.
postcodestring- Postcode or ZIP code. Structured address input; do not use with text. Example: 10117.
statestring- State or region name. Structured address input; do not use with text. Example: Berlin.
streetstring- Street name. Structured address input; do not use with text. Example: Pariser Platz.
textstring- Free-form address query. Alternative to the structured address parameters; do not combine them. Example: Potsdamer Platz, Berlin.
typestring- Requested location type. Example: country.one of
countrystatecitypostcodestreetamenitylocality
geoapify_geometry_combineCombine two or more stored geometries or isolines by ID with union or intersection.Read-onlyCombine Stored Geometries
Combine two or more stored geometries or isolines by ID with union or intersection. Returns the combined GeoJSON feature, optionally with extra details. Store geometries with geoapify_geometry_store or create isolines with geoapify_isoline_get first.
Inputs
idarrayrequired- IDs of two or more stored geometries or isolines to combine (from geoapify_geometry_store or geoapify_isoline_get). Example: ["a3f2029c4c2741f40782725fa0dc88be", "1a98e89ca85dcc8251211d7d83e16512"].
operationstringrequired- Required operation. union merges all input areas; intersection keeps only their common area.one of
intersectionunion detailsstring- Extra datasets to add to the result, such as population. Separate multiple values with ,. Example: population.
formatstring- Response encoding. The documented response schema and example describe the default GeoJSON format. Example: geojson.one of
jsongeojson
geoapify_geometry_operationRun a geometry operation such as length, area, buffer, union, intersection, distance, centroid, simplify or bounding box on GeoJSON geometries.Read-onlyRun Geometry Operation
Run a geometry operation such as length, area, buffer, union, intersection, distance, centroid, simplify or bounding box on GeoJSON geometries. Returns the operation result: a measurement or a new GeoJSON geometry. Use geoapify_geometry_combine to combine stored isolines or geometries by ID.
Inputs
operationstringrequired- Geometry operation to run, for example length, area, buffer, union, intersection, difference, distance, centroid, bbox, simplify, contains or within. Example: area.
argumentsobject- The operation's inputs as one object, using the field names Geoapify documents for that operation: geometry, geometry1/geometry2, geometries, point, polygon, line, bbox, distance, params and so on. Coordinates are GeoJSON [longitude, latitude]. Example: {"geometry": {"type": "Polygon", "coordinates": [[[13.37, 52.51], [13.39, 52.51], [13.39, 52.52], [13.37, 52.51]]]}}.
geoapify_ip_info_getLook up the approximate location of an IP address, or of the caller when ip is empty.Read-onlyGet IP Location
Look up the approximate location of an IP address, or of the caller when ip is empty. Returns city, state, country (with ISO codes and names), continent, coordinates and the IP. Use to localize users by IP.
Inputs
ipstring- IPv4 or IPv6 address. The client address is used when omitted. Example: 93.109.164.24.
langstring- Result language. Default: en.
geoapify_isoline_getCalculate the area reachable from a point within a travel time or distance (isochrone or isodistance) by car, truck, bike, foot or transit.Read-onlyGet Isoline
Calculate the area reachable from a point within a travel time or distance (isochrone or isodistance) by car, truck, bike, foot or transit. Returns a GeoJSON feature collection of reachability polygons with an id for later use, or a pending status for large ranges. Repeat the call with the returned id to fetch a pending isoline.
Inputs
avoidarray- Routing features or areas to avoid. Examples include tolls, highways, ferries, location:latitude,longitude, polygon:lat,lon;lat,lon;..., and country_codes:us,ca. Example: ["tolls", "ferries"].
detailsstring- Extra datasets to add to every isoline feature, such as population. Separate multiple values with ,. Example: population.
formatstring- Response encoding. The documented success schema and example describe the default geojson format.one of
jsongeojson idstring- ID returned for a previously generated isoline. Use id by itself instead of the calculation parameters. Example: 51a5c7bdd1f2a52a40595d1d7a55743b4a40f00103f90146f3.
latnumber- Origin latitude in decimal degrees. Required when calculating an isoline; omit when retrieving by id. Example: 52.5163.
lonnumber- Origin longitude in decimal degrees. Required when calculating an isoline; omit when retrieving by id. Example: 13.3777.
max_speednumber- Optional maximum travel speed: 10–252 km/h with metric units or 6.5–155 mph with imperial units. Example: 80.
modestring- Travel mode used to calculate reachability. drive represents passenger-car routing. Required when calculating.one of
walkhikescootermotorcycledrivelight_truckbicyclemountain_bikeroad_bikebusmedium_trucktrucktruck_dangerous_goodsheavy_trucklong_trucktransitapproximated_transit rangestring- One to 10 reachability limits. Required when calculating. Values are seconds for type=time; for type=distance, values are meters with metric units or miles with imperial units. Separate multiple values with ,. Example: 900,1800.
route_typestring- Route optimization preference: balanced, shortest distance, or fewer maneuvers. Default: balanced.one of
balancedshortless_maneuvers trafficstring- Traffic model. Use approximated to account for typical traffic where supported. Default: free_flow.one of
free_flowapproximated typestring- Isoline kind. Use time for an isochrone or distance for an isodistance. Required when calculating.one of
timedistance unitsstring- Unit system for distance ranges and max_speed. Metric uses meters and km/h; imperial uses miles and mph. Time ranges are always seconds. Default: metric.one of
metricimperial
geoapify_map_matchSnap an ordered GPS track to the road network for a travel mode.Read-onlyMatch GPS Track
Snap an ordered GPS track to the road network for a travel mode. Returns the matched route as GeoJSON with distance, time, legs and steps, plus optional address and OSM tags per step. Use geoapify_routing to route between points instead.
Inputs
modestringrequired- Travel profile used to decide which roads can plausibly connect the GPS measurements. drive represents a passenger car.one of
walkhikescootermotorcycledrivelight_truckbicyclemountain_bikeroad_bikebusmedium_trucktrucktruck_dangerous_goodsheavy_trucklong_truck waypointsarrayrequired- Ordered GPS measurements to match. Input order is preserved; the API does not optimize or reorder these points. Example: [{"timestamp": "2026-11-16T10:00:00Z", "location": [13.3777, 52.5163]}, {"timestamp": "2026-11-16T10:01:00Z", "location": [13.38, 52.517]}].
geocode_step_addressboolean- When true, reverse-geocodes matched route steps and adds address data. Each geocoded step adds API credit cost. Default: False. Example: false.
langstring- Language code used for any generated address or instruction text. Default: en.one of
endeesfrhiitptruslsvcacs lookup_osm_overlapboolean- When true, includes OpenStreetMap overlap information for matched route steps. Each lookup step adds API credit cost. Default: False. Example: false.
lookup_step_osmtagsboolean- When true, looks up OpenStreetMap tags for matched route steps. Each lookup step adds API credit cost. Default: False. Example: false.
geoapify_place_details_getGet details of a place by Geoapify place ID, coordinates or OSM ID: contacts, opening hours, building and nearby radius features.Read-onlyGet Place Details
Get details of a place by Geoapify place ID, coordinates or OSM ID: contacts, opening hours, building and nearby radius features. Returns GeoJSON features with name, address, categories, contact details, opening hours and geometry. Get place IDs from geoapify_places_search or a geocoding result.
Inputs
featuresstring- Primary feature groups to return. Separate multiple values with |. details returns the place record and geometry, building returns the containing building, radius groups describe fixed-distance surroundings, and walk_* or drive_* groups return reachability isolines. Defaults to details. See the [feature reference](https://apidocs.geoapify.com/docs/place-details/#api). Example: details|building.
idstring- Geoapify place identifier returned by the Geocoding, Places, or related Geoapify APIs. This is the recommended lookup method; do not combine it with coordinates or OpenStreetMap identifiers. Example: 51a5c7bdd1f2a52a40595d1d7a55743b4a40f00103f90146f3.
langstring- Language used for names and address fields. Default: en.
latnumber- Latitude of the location to inspect. Alternative to id; provide it together with lon and leave it unset when using a place ID. Example: 52.5163.
lonnumber- Longitude of the location to inspect. Alternative to id; provide it together with lat and leave it unset when using a place ID. Example: 13.3777.
osm_idinteger- Numeric OpenStreetMap object identifier. Alternative to id; use together with osm_type and leave it unset when using a place ID. Example: 240109189.
osm_typestring- OpenStreetMap object type used with osm_id: n for node, w for way, or r for relation.one of
rwn
geoapify_place_info_getGet information about the place or building at a location or OSM ID, including the address.Read-onlyGet Place Info
Get information about the place or building at a location or OSM ID, including the address. Returns the place with name, categories, address and building details. Use geoapify_place_details_get for richer details by place ID.
Inputs
isBuildingboolean- Whether the requested object is a building. Example: false.
langstring- Result language. Default: en.
latnumber- Place latitude. Must be used with lon. Example: 52.5163.
lonnumber- Place longitude. Must be used with lat. Example: 13.3777.
namestring- Optional place name. Example: Brandenburger Tor.
osm_idnumber- OpenStreetMap object identifier. Example: 240109189.
osm_typestring- OpenStreetMap object type.one of
rwn skipAddressboolean- Skip address enrichment. Example: false.
geoapify_places_searchFind places (points of interest) by category within an area or near a point, such as restaurants, supermarkets or charging stations.Read-onlySearch Places
Find places (points of interest) by category within an area or near a point, such as restaurants, supermarkets or charging stations. Returns GeoJSON features with name, categories, address, coordinates and distance, with paging via limit and offset. Use geoapify_places_search_by_geometry to search inside a custom polygon.
Inputs
categoriesstringrequired- One or more comma-separated place category keys. Categories are hierarchical: a parent category such as commercial includes its child categories. Use a more specific key, such as commercial.supermarket, to narrow the results. See the [complete category reference](https://apidocs.geoapify.com/docs/places/#categories). Separate multiple values with ,. Example: catering.restaurant.
biasstring- Ranking preference that prioritizes places without excluding other results. Supported forms are proximity:lon,lat, circle:lon,lat,radiusMeters, and rect:lon1,lat1,lon2,lat2. Provide filter, bias, or both. Example: proximity:13.3777,52.5163.
conditionsstring- Optional comma-separated conditions that restrict results by place attributes. Conditions are hierarchical: a parent such as wheelchair includes its child conditions, while wheelchair.yes requests fully wheelchair-accessible places. See the [complete condition reference](https://apidocs.geoapify.com/docs/places/#conditions). Separate multiple values with ,.
filterstring- Spatial constraint that limits which places can be returned. Supported forms are circle:lon,lat,radiusMeters, rect:lon1,lat1,lon2,lat2, geometry:geometryId, place:placeId, and countrycode:code. Multiple filters can be joined with | and use AND logic. Provide filter, bias, or both. Example: countrycode:de.
langstring- Language for names and address fields. Default: en.
limitinteger- Maximum number of places returned per page. Default: 20.
namestring- Optional place-name filter. Only places matching this name are returned. Example: Brandenburger Tor.
offsetinteger- Zero-based result offset for pagination. Use with limit to request the next page. Default: 0.
geoapify_places_search_by_geometryFind places by category inside or near a GeoJSON geometry passed in the body, such as a polygon or isoline.Read-onlySearch Places In Geometry
Find places by category inside or near a GeoJSON geometry passed in the body, such as a polygon or isoline. Give a filter or a bias. Returns GeoJSON features with name, categories, address and coordinates. Use geoapify_places_search for rectangle, circle or place-ID filters.
Inputs
categoriesarrayrequired- One or more place category keys. Example: ["catering.restaurant"].
biasobject- Rank results by closeness, as an object with a type: proximity (lon, lat), circle or rect. Example: {"type": "proximity", "lon": 13.3777, "lat": 52.5163}.
conditionsarray- Place-attribute conditions that results must meet, such as wheelchair.yes or internet_access. Example: ["wheelchair.yes"].
filterobject- Area to search, as one object with a type: circle (lon, lat, radius in meters), rect (lon1, lat1, lon2, lat2), polygon or polyline (a GeoJSON geometry, optional buffer in meters), geometry (a stored geometry id), place (a place id) or countrycode. Example: {"type": "circle", "lon": 13.3777, "lat": 52.5163, "radius": 1000}.
langstring- lang Default: en.
limitinteger- limit Default: 20.
namestring- Only places whose name matches this text. Example: Starbucks.
offsetinteger- offset Default: 0.
geoapify_postcode_searchFind the postcode area for a postcode or for coordinates.Read-onlyGet Postcode
Find the postcode area for a postcode or for coordinates. Returns the postcode feature with postcode, city, state, country and optional geometry. Use geoapify_postcodes_list to list postcodes in an area.
Inputs
countrycodestring- Optional ISO 3166-1 alpha-2 country code filter.
formatstring- Response format. Default: geojson.one of
jsongeojson geometrystring- Postcode geometry representation. Use point for centroid geometry or original for source geometry. Default: point.one of
pointoriginal langstring- Result language as a supported two-letter language code. Default: en.
latnumber- Latitude for reverse postcode search. Must be used together with lon and without postcode. Example: 52.5163.
lonnumber- Longitude for reverse postcode search. Must be used together with lat and without postcode. Example: 13.3777.
postcodestring- Postcode text to search. Mutually exclusive with lat/lon coordinate search. Example: 10117.
geoapify_postcodes_listList the postcodes in an area or matching text, with paging.Read-onlyList Postcodes
List the postcodes in an area or matching text, with paging. Returns postcode features with postcode, city, state, country and optional geometry. Use geoapify_postcode_search for one postcode.
Inputs
biasstring- Optional result bias. Supported values include proximity:lon,lat, circle:lon,lat,radius, and rect:lon1,lat1,lon2,lat2. Multiple bias values can be repeated or separated with |. Separate multiple values with |. Example: proximity:13.3777,52.5163.
countrycodestring- Optional ISO 3166-1 alpha-2 country code filter.
filterstring- Optional spatial or place filter. Supported values include rect:lon1,lat1,lon2,lat2, circle:lon,lat,radius, and place:place_id. Multiple filters can be repeated or separated with |. Separate multiple values with |. Example: countrycode:de.
formatstring- Response format. Default: geojson.one of
jsongeojson geometrystring- Postcode geometry representation. Use point for centroid geometry or original for source geometry. Default: point.one of
pointoriginal langstring- Result language as a supported two-letter language code. Default: en.
limitinteger- Maximum number of postcode results to return. Default: 5. Example: 20.
offsetinteger- Number of matching results to skip. Default: 0.
textstring- Free-text postcode query. Example: Potsdamer Platz, Berlin.
geoapify_route_matrixCalculate travel time and distance between every source and every target for a travel mode.Read-onlyGet Route Matrix
Calculate travel time and distance between every source and every target for a travel mode. Returns sources_to_targets, a matrix of rows (one per source) with distance and time per target. Use geoapify_routing for the full path between two points.
Inputs
modestringrequired- Travel profile used to calculate speeds, access rules, and road restrictions. drive represents a passenger car.one of
walkhikescootermotorcycledrivelight_truckbicyclemountain_bikeroad_bikebusmedium_trucktrucktruck_dangerous_goodsheavy_trucklong_truck sourcesarrayrequired- Origin locations. Each source produces one row in sources_to_targets. Example: [{"location": [13.3777, 52.5163]}].
targetsarrayrequired- Destination locations. Each target produces one column in every sources_to_targets row. Example: [{"location": [13.405, 52.52]}, {"location": [13.43, 52.5]}].
avoidarray- Rules for what routes should avoid. Each rule has a type (tolls, ferries, highways, green_zones, transfers, locations, polygons or country_codes), an optional importance from 0 to 1, and values for locations, polygons or countries. Example: [{"type": "tolls"}, {"type": "country_codes", "values": ["ch"]}].
max_speednumber- Maximum speed for driving, truck, and bus modes. Use 10–252 km/h with units=metric, or 6.5–155 mph with units=imperial. Example: 80.
trafficstring- Traffic model for motorized modes. free_flow assumes uncongested roads; approximated reduces speeds on roads likely to be congested. Default: free_flow.one of
free_flowapproximated typestring- Route preference. balanced balances time and distance; short prioritizes distance; less_maneuvers penalizes turns. Default: balanced.one of
balancedshortless_maneuvers unitsstring- Unit system for matrix distances. metric returns meters; imperial returns miles. Default: metric.one of
metricimperial
geoapify_route_planSolve a vehicle routing problem: assign jobs and pickup-delivery shipments to agents (vehicles or workers) with time windows, capacities and skills.Read-onlyPlan Routes
Solve a vehicle routing problem: assign jobs and pickup-delivery shipments to agents (vehicles or workers) with time windows, capacities and skills. Returns a feature collection with one optimized route per agent, plus unassigned jobs and shipments. Use geoapify_routing for a single route.
Inputs
agentsarrayrequired- Resources—such as vehicles or workers—to which jobs and shipments can be assigned. Example: [{"start_location": [13.3777, 52.5163], "time_windows": [[0, 28800]]}].
modestringrequired- Travel profile used for all agent routes. drive represents passenger cars.one of
walkhikescootermotorcycledrivelight_truckbicyclemountain_bikeroad_bikebusmedium_trucktrucktruck_dangerous_goodsheavy_trucklong_truck avoidarray- Rules for what routes should avoid. Each rule has a type (tolls, ferries, highways, green_zones, transfers, locations, polygons or country_codes), an optional importance from 0 to 1, and values for locations, polygons or countries. Example: [{"type": "tolls"}, {"type": "country_codes", "values": ["ch"]}].
jobsarray- Independent service or delivery tasks. At least one job or shipment is required. Example: [{"location": [13.405, 52.52], "duration": 300}].
locationsarray- Reusable locations that agents, jobs and shipments can point to by zero-based location_index, each with a location [longitude, latitude] and optional id. At most 300 unique coordinates per call. Example: [{"id": "warehouse", "location": [13.3777, 52.5163]}].
max_speednumber- Maximum speed for driving, truck, and bus modes. Use 10–252 km/h with units=metric, or 6.5–155 mph with units=imperial. Example: 80.
shipmentsarray- Paired pickup-delivery tasks. Pickup always precedes delivery and both are assigned to the same agent. Example: [{"id": "order-1", "pickup": {"location": [13.38, 52.51], "duration": 120}, "delivery": {"location": [13.43, 52.5], "duration": 120}}].
trafficstring- Traffic model for motorized modes. free_flow assumes uncongested roads; approximated accounts for likely congestion. Default: free_flow.one of
free_flowapproximated typestring- Route preference used for agent travel. balanced balances time and distance; short prioritizes distance; less_maneuvers penalizes turns. Default: balanced.one of
balancedshortless_maneuvers unitsstring- Unit system for returned route distances. metric returns meters; imperial returns miles. Default: metric.one of
metricimperial
geoapify_routingCalculate a route through two or more waypoints for a travel mode (drive, truck, bicycle, walk, transit and more), optionally optimizing the stop order.Read-onlyGet Route
Calculate a route through two or more waypoints for a travel mode (drive, truck, bicycle, walk, transit and more), optionally optimizing the stop order. Returns the route as GeoJSON with distance, time, legs and turn-by-turn steps. Use geoapify_route_matrix for many-to-many travel times and geoapify_route_plan for multi-vehicle planning.
Inputs
modestringrequired- Travel profile used to calculate speeds, access rules, and road restrictions. drive represents a passenger car.one of
walkhikescootermotorcycledrivelight_truckbicyclemountain_bikeroad_bikebusmedium_trucktrucktruck_dangerous_goodsheavy_trucklong_trucktransitapproximated_transit waypointsstringrequired- Ordered route points. Use latitude,longitude for each point (latitude from -90 to 90; longitude from -180 to 180) and separate points with |. At least two waypoints are required. Separate multiple values with |. Example: {'timestamp': '2026-11-16T10:00:00Z', 'location': [13.3777, 52.5163]}|{'timestamp': '2026-11-16T10:01:00Z', 'location': [13.38, 52.517]}.
avoidstring- Road features, locations, polygons, or countries to avoid. Separate multiple rules with |. An optional importance from 0 to 1 can follow road-feature rules, for example tolls:0.8. Separate multiple values with |. Example: tolls|ferries.
detailsstring- Additional result data. instruction_details adds maneuver metadata; route_details adds road attributes; elevation adds the elevation profile; admin_areas adds country and state metadata and administrative area crossings. polyline5 and polyline6 add encoded geometry to the route properties and every leg without replacing the GeoJSON geometry.
formatstring- Response representation. geojson returns a GeoJSON FeatureCollection; json returns route objects with {lon, lat} geometry points; xml returns the JSON structure serialized as XML. Default: geojson.one of
jsongeojson intermediate_waypoint_modestring- Treatment of intermediate waypoints. stopover splits the route into independent legs; through_stop splits it into legs while preserving travel direction; pass_through treats it as a via point without creating a new leg. Default: stopover.one of
stopoverthrough_stoppass_through langstring- Language code for human-readable turn-by-turn instructions. Example: en.one of
bgcacsdadeelen-GBenesetfifrhihuitjanb-NOnlplpt-BRptroruskslsvtruk max_speednumber- Maximum speed for driving, truck, and bus modes. Use 10–252 km/h with units=metric, or 6.5–155 mph with units=imperial. Example: 80.
optimize_stopsboolean- Whether to optimize the order of intermediate waypoints. The first and last waypoints remain fixed. Default: False. Example: false.
trafficstring- Traffic model for motorized modes. free_flow assumes uncongested roads; approximated reduces speeds on roads likely to be congested. Default: free_flow.one of
free_flowapproximated typestring- Route preference. balanced balances time and distance; short prioritizes distance; less_maneuvers penalizes turns and is supported only for motorized road modes. Default: balanced.one of
balancedshortless_maneuvers unitsstring- Unit system for distances in the response. metric returns meters; imperial returns miles. Default: metric.one of
metricimperial
geoapify_timezone_getGet the time zone at a location, optionally at a given moment.Read-onlyGet Timezone
Get the time zone at a location, optionally at a given moment. Returns the time zone name, abbreviation, UTC and DST offsets and the local time. Use geoapify_timezone_transitions_list for DST change dates.
Inputs
latnumberrequired- Latitude. Example: 52.5163.
lonnumberrequired- Longitude. Example: 13.3777.
atstring- RFC 3339 instant with an offset. Defaults to now. Example: 2026-11-16T12:00:00Z.
geoapify_timezone_transitions_listList the UTC offset transitions (such as daylight saving changes) of the time zone at a location within a period.Read-onlyList Timezone Transitions
List the UTC offset transitions (such as daylight saving changes) of the time zone at a location within a period. Returns the time zone and its transitions with dates and new offsets. Use geoapify_timezone_get for the current offset.
Inputs
fromstringrequired- Inclusive RFC 3339 start instant. Example: 2026-01-01T00:00:00Z.
latnumberrequired- Latitude. Example: 52.5163.
lonnumberrequired- Longitude. Example: 13.3777.
tostringrequired- Exclusive RFC 3339 end instant. Example: 2027-01-01T00:00:00Z.
geoapify_batch_createStart an asynchronous batch job that runs one Geoapify API (for example routing, isoline or place details) for many inputs at reduced cost.WriteStart Batch Job
Start an asynchronous batch job that runs one Geoapify API (for example routing, isoline or place details) for many inputs at reduced cost. Returns the job id and status. Poll geoapify_batch_get with the id for results; use the batch geocoding tools for addresses.
Inputs
apistringrequired- Geoapify API path to run for each input, for example /v1/routing, /v1/isoline or /v2/place-details. Example: /v1/routing.one of
/v1/isoline/v1/routing/v1/places/v1/geometry/v1/geocode/search/v1/geocode/reverse/v1/mapmatching/v2/places/v2/place-info/v2/place-details/v1/ipinfo/v1/routeplanner/v1/routematrix/v1/boundaries/part-of/v1/boundaries/consists-of/v1/boundaries/near-by/v1/boundaries/parent-of inputsarrayrequired- One entry per call to run, 1 to 1,000. Each has an optional id and the params (query parameters) and/or body for that call, which are merged with the shared params and body. Example: [{"id": "1", "params": {"waypoints": "52.5163,13.3777|52.52,13.405"}}].
bodyobject- JSON body shared by all inputs, for batch APIs that take a POST body (for example route matrix). Example: {"mode": "drive"}.
paramsobject- Request-level query parameters applied to all batch inputs. Example: {"mode": "drive"}.
prioritynumber- Processing priority and credit-cost factor. Use 0.5 to spend 50% of the normal credits when longer processing is acceptable, or 1 to spend the full credits for faster processing. Values between 0.5 and 1 balance the discount and processing speed. Default: 0.5.
geoapify_batch_geocode_reverse_createStart an asynchronous job that reverse geocodes up to 1,000 coordinates at once (batch pricing).WriteStart Batch Reverse Geocoding
Start an asynchronous job that reverse geocodes up to 1,000 coordinates at once (batch pricing). Returns the job id and status; results are not ready immediately. Poll geoapify_batch_geocode_reverse_get with the id.
Inputs
locationsarrayrequired- Coordinates to reverse geocode, 1 to 1,000, each as an object with lat and lon. Example: [{"lat": 52.5163, "lon": 13.3777}].
countrycodesstring- Comma-separated ISO 3166-1 alpha-2 country code filters. Example: de,at.
langstring- Result language as a supported two-letter language code. Example: en.
prioritynumber- Optional batch processing priority factor. Example: 0.5.
typestring- Optional reverse geocoding result type filter. Example: country.one of
countrystatecitypostcodestreetamenitylocalitybuilding
geoapify_batch_geocode_search_createStart an asynchronous job that geocodes up to 1,000 addresses at once (batch pricing).WriteStart Batch Geocoding
Start an asynchronous job that geocodes up to 1,000 addresses at once (batch pricing). Returns the job id and status; results are not ready immediately. Poll geoapify_batch_geocode_search_get with the id until the results come back.
Inputs
addressesarrayrequired- Free-text addresses or place queries to geocode, 1 to 1,000. Example: ["668 Cedar St, San Carlos, CA 94070", "Potsdamer Platz, Berlin"].
biasstring- Optional geocoding bias expression. Example: proximity:13.3777,52.5163.
countrycodesstring- Comma-separated ISO 3166-1 alpha-2 country code filters. Example: de,at.
filterstring- Optional geocoding filter expression. Example: countrycode:de.
langstring- Result language as a supported two-letter language code. Example: en.
latnumber- Latitude for an optional geocoding bias. Must be used together with lon. Example: 52.5163.
lonnumber- Longitude for an optional geocoding bias. Must be used together with lat. Example: 13.3777.
prioritynumber- Optional batch processing priority factor. Example: 0.5.
textstring- Default text query applied with request-level parameters. Example: Potsdamer Platz, Berlin.
typestring- Optional result type filter. Example: country.one of
countrystatecitypostcodestreetamenitylocality
geoapify_geometry_storeStore a GeoJSON geometry, feature or feature collection on Geoapify so it can be combined by ID.WriteStore Geometry
Store a GeoJSON geometry, feature or feature collection on Geoapify so it can be combined by ID. Returns the stored geometry's id. Combine stored geometries with geoapify_geometry_combine.
Inputs
geojsonobjectrequired- GeoJSON Geometry, Feature or FeatureCollection to store, coordinates as [longitude, latitude]. Example: {"type": "Feature", "properties": {}, "geometry": {"type": "Point", "coordinates": [13.4, 52.5]}}.
No tools match.