Geoapify | Composio Docs

Overview

SLUG: GEOAPIFY

Description

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

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Geoapify

Create an auth config

Use the dashboard to create an auth config for the Geoapify toolkit. This allows you to connect multiple Geoapify accounts to Composio for agents to use.

Select App

Navigate to Geoapify.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Geoapify Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 geoapify_auth_config_id = "ac_YOUR_GEOAPIFY_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Geoapify for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, geoapify_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Geoapify toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["GEOAPIFY"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

GEOAPIFY_ADDRESS_AUTOCOMPLETE

Tool Name: Address Autocomplete

Description

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

Action Parameters

bias

string

filter

string

format

string

lang

string

limit

integer

text

stringRequired

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_BATCH_REQUESTS

Tool Name: Batch Requests

Description

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

Action Parameters

api

string

body

object

string

inputs

array

params

object

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_BOUNDARIES

Tool Name: Get Administrative Boundaries

Description

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.

Action Parameters

boundaries

stringDefaults to administrative

geometry

stringDefaults to point

string

lang

string

lat

number

lon

number

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_FORWARD_GEOCODING

Tool Name: Forward Geocoding

Description

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

Action Parameters

apiKey

stringRequired

bias

string

city

string

country

string

filter

string

format

stringDefaults to geojson

housenumber

string

lang

string

limit

integerDefaults to 5

name

string

postcode

string

state

string

street

string

text

string

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_GEOMETRY

Tool Name: Geometry Operation

Description

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

Action Parameters

arrayRequired

operation

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_IP_GEOLOCATION

Tool Name: IP Geolocation

Description

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

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_ISOLINE

Tool Name: Generate isoline (isochrone/isodistance)

Description

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

Action Parameters

avoid

string

lat

number

lon

number

max_speed

integer

mode

string

range

integer

route_type

string

traffic

string

type

string

units

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_MAP_MATCHING

Tool Name: Map Matching

Description

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

Action Parameters

apiKey

stringRequired

mode

stringRequired

waypoints

arrayRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_MAP_TILES

Tool Name: Fetch Geoapify Map Tiles

Description

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

Action Parameters

apiKey

stringRequired

mode

stringDefaults to tile

retina

boolean

style

stringRequired

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_MARKER_ICON

Tool Name: Create Marker Icon

Description

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

Action Parameters

color

string

contentColor

string

contentSize

integer

icon

string

iconType

string

noShadow

boolean

noWhiteCircle

boolean

shadowColor

string

size

integer

strokeColor

string

text

string

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_PLACE_DETAILS

Tool Name: Place Details

Description

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

Action Parameters

features

string

lang

string

lat

number

lon

number

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_PLACES

Tool Name: Places Search

Description

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

Action Parameters

bias

string

GEOAPIFY_POSTCODE

Tool Name: Postcode Search

Description

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

Action Parameters

countrycode

string

format

string

geometry

string

lang

string

lat

number

lon

number

postcode

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_REVERSE_GEOCODING

Tool Name: Reverse Geocoding

Description

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

Action Parameters

format

stringDefaults to geojson

lang

string

lat

numberRequired

limit

integer

lon

numberRequired

type

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_ROUTE_MATRIX

Tool Name: Route Matrix

Description

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

Action Parameters

apiKey

stringRequired

avoid

array

max_speed

number

mode

string

sources

array

targets

array

traffic

string

type

string

units

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_ROUTE_PLANNER

Tool Name: Route Planner

Description

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

Action Parameters

agents

array

avoid

array

jobs

array

locations

array

max_speed

number

mode

string

shipments

array

traffic

string

type

string

units

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

GEOAPIFY_ROUTING

Tool Name: Routing

Description

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

Action Parameters

avoid

string

details

string

format

stringDefaults to geojson

lang

string

max_speed

integer

mode

stringDefaults to drive

traffic

stringDefaults to free_flow

type

stringDefaults to balanced

units

stringDefaults to metric

waypoints

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired