Google Maps API
google_maps
85% off
Search Google Maps for local businesses and places.
Search Google Maps for businesses, landmarks, and other places. Results use a stable APINEED response shape with location, rating, contact, and Google place identifiers when available.
TYPEMap resultsPRICE$0.00375 per requestRESPONSEStructured JSON
{
"request_id": "example_google_maps",
"tool": "google_maps",
"output": {
"map_center": "@37.7749,-122.4194,14z",
"page": 1,
"places": [
{
"address": "San Francisco, CA",
"place_id": "example-place-id",
"position": 1,
"title": "Coffee Shop",
"type": "Coffee shop"
}
],
"query": "coffee San Francisco"
},
"usage": {
"price_usd": "0.00375",
"quota": 1875
}
}Google Maps API Pricing
Current pricing from the APINEED catalog. Failed requests are refunded; server usage records remain authoritative.
Quick Start
Invoke Google Maps with one APINEED key and a JSON request body.
Use your APINEED API key
Reuse the same APINEED API key that your application already uses for LLM, image, and video APIs. Keep it server-side.
Create API keyexport API_NEED_API_KEY=sk-apineed-v1-...Send the request
POST the same input shown in the Playground to /v1/tools/google_maps/invoke.
curl 'https://apineed.com/v1/tools/google_maps/invoke' \
-H "Authorization: Bearer $API_NEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"language": "en",
"ll": "@37.7749,-122.4194,14z",
"page": 1,
"query": "coffee San Francisco"
}'Read the response
Use output.places for the result and usage.price_usd for the settled request price.
const places = response.output.places;Endpoint
This endpoint uses bearer-token authentication and returns a synchronous normalized JSON response.
POST
/v1/tools/google_maps/invoke- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- Billing
- $0.00375 per request on successful invocation
- Response
- request_id, tool, output, usage
Google Maps API Parameters
Only query is required. ll can pin the map center and zoom; place_id or cid can narrow the search to a known Google place.
| Name | Type | Requirement | Values | Description |
|---|---|---|---|---|
query | string | Required | 1–500 characters | The Maps search query. |
cid | string | Optional | 1–500 characters | Optional Google CID. |
language | string | Optional | Pattern: ^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$ | Optional result language. |
ll | string | Optional | 0–128 characters | Optional map center and zoom in @latitude,longitude,zoom format. |
page | integer | Optional | 1–100 | Optional results page number. |
place_id | string | Optional | 1–500 characters | Optional Google place ID. |
Google Maps API Introduction
A practical guide to the request, response, billing, and application use cases.
Google Maps API
Search Google Maps for businesses, landmarks, and other places. Results use a stable APINEED response shape with location, rating, contact, and Google place identifiers when available.
Local discovery
Find nearby businesses, venues, and points of interest from a natural-language query.
Location enrichment
Collect addresses, coordinates, ratings, websites, and phone numbers for place records.
Map research
Build travel, market-research, and local-search workflows without maintaining a Maps scraper.
Request contract
Send a JSON object to /v1/tools/google_maps/invoke. Use the required fields, supported optional parameters, and bounds listed above. Undocumented parameters are not guaranteed to be supported.
Response and usage
Read the tool result from output.places and the settled charge from usage.price_usd. Keep request_id for troubleshooting. Preserve optional response fields rather than assuming they are always present.
Common Questions
Practical answers about authentication, parameters, pricing, and integration.
What does Google Maps API do?
Search Google Maps for businesses, landmarks, and other places. Results use a stable APINEED response shape with location, rating, contact, and Google place identifiers when available.
How do I authenticate?
Send a POST request to /v1/tools/google_maps/invoke with your APINEED API key in the Authorization: Bearer header. The same key can be used for model APIs. Keep the key on your server, not in browser code.
Can I try this API without entering an API key?
Yes. The Playground uses your signed-in APINEED account and shared balance. Sign in to send a request, or add funds if your balance is insufficient.
Which input fields are required?
Required fields: query. Check the parameter table for types, allowed values, and limits.
Can I omit optional parameters?
Yes. Optional fields: cid, language, ll, page, place_id. Omitted fields are not sent. Explicit false and 0 values are preserved; use the defaults and limits documented in the parameter table.
How much does a request cost?
The current catalog price is $0.00375 per request. The final charge is recorded in usage.price_usd and your account usage logs. Failed requests are refunded.
How should I read the response?
A successful invocation returns request_id, tool, output, and usage. Read the result from output, preserve request_id for troubleshooting, and inspect usage for the settled charge. The Playground shows the returned JSON without changing it.