API di Google Maps

Google Maps Ricerca API

Cerca su Google Maps luoghi che corrispondono a una query e a una località: fino a 20 record di luoghi normalizzati con valutazioni, indirizzi e contatti di base per richiesta.

1,40 USD/1k richieste, paghi a richiesta, nessun abbonamento.

coffee shop - Google Maps
google.com/maps/search/coffee%20shop
coffee shop in Austin, TX
ResultsShare

Mañana Coffee House

4.6(1,284)

Coffee shop · 612 W 6th St, Austin, TX 78701, USA

Mañana Coffee House
Google Maps
Cosa ha restituito l'APIitems[0]
{
"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"cid": "8234917364550128200",
"name": "Mañana Coffee House",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"category": "Coffee shop",
"categories": [...],
"address": "612 W 6th St, Austin, TX 78701, USA",
"street": "612 W 6th St",
... 14 campi in più
}
Disponibilità
100,00%
30d · 79.600 chiamate
Richieste
80.016
30 g · settimanale, ultime 12 sett.
Risposta
2,8s
mediana · 30d

Prezzi e provider

Prezzi dell'API Google Maps Ricerca: una sola API, 9 provider intercambiabili

Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.

Paghi
14,00 USD
1,40 USD/1k richieste, solo per ciò che usi. Nessun piano mensile.
Le tue prime 71 richieste sono gratuite con il saldo iniziale di 0,10 USD.

Provalo

Ottieni Google Maps Ricerca in una sola richiesta

requireFieldsarray
Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `cid` o `street`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un luogo che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

Questo esempio mostra 24 campi su 26. Vedi tutti i campi

{
  "found": true,
  "data": {
    "items": [
      {
        "placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "cid": "8234917364550128200",
        "name": "Mañana Coffee House",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Breakfast restaurant",
          "Bakery"
        ],
        "address": "612 W 6th St, Austin, TX 78701, USA",
        "street": "612 W 6th St",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78701",
        "countryCode": "US",
        "latitude": 30.2687,
        "longitude": -97.7469,
        "phone": "+1 512-555-0142",
        "website": "https://mananacoffeeaustin.com",
        "rating": 4.6,
        "reviewCount": 1284,
        "priceLevel": "$$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no"
      },
      {
        "placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "cid": "5127740981263455000",
        "name": "Radio Coffee & Beer",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Bar"
        ],
        "address": "4204 Menchaca Rd, Austin, TX 78704, USA",
        "street": "4204 Menchaca Rd",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78704",
        "countryCode": "US",
        "latitude": 30.2277,
        "longitude": -97.7808,
        "phone": "+1 512-555-0187",
        "website": "https://radiocoffeeandbeer.com",
        "rating": 4.7,
        "reviewCount": 3021,
        "priceLevel": "$$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHRadioCoffeeBeerPatio=w400-h300-k-no"
      },
      {
        "placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "name": "Summer Moon Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop"
        ],
        "address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
        "street": "1900 Aldrich St Ste 100",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78723",
        "countryCode": "US",
        "latitude": 30.296,
        "longitude": -97.7028,
        "website": "https://summermooncoffee.com",
        "rating": 4.5,
        "reviewCount": 642,
        "priceLevel": "$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHSummerMoonAldrich=w400-h300-k-no"
      }
    ]
  }
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-11-21 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

  • locationstring

    Austin, TX

    Località libera in cui cercare, meglio se città più paese (es. Austin, USA).

  • querystring

    coffee shop

    Ciò che digiteresti nella barra di ricerca di Google Maps (es. coffee shop).

  • categoryFilterWordsarray

    Elenco facoltativo di nomi di categorie dei luoghi di Google Maps da mantenere; i risultati sono limitati ai luoghi la cui categoria corrisponde a uno di questi. Usa i nomi delle categorie in minuscolo come mostrati su Google Maps (es. ["coffee shop", "restaurant"]). Omettilo per includere tutte le categorie e restare sul prezzo più basso; un filtro per categoria instrada a una fonte più cara.

  • languagestring

    Codice lingua di due lettere per i risultati (es. en).

  • limitinteger

    3

    Numero massimo di risultati da restituire (1-20, predefinito 20). Il prezzo dipende dal provider selezionato e può essere fisso a richiesta.

  • placeMinimumStarsenum

    Restituisci solo i luoghi con almeno questa valutazione media: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) o fourAndHalf (4.5+). I luoghi senza recensioni sono esclusi. Omettilo per restare sul prezzo più basso; una soglia di valutazione instrada a una fonte più cara.

  • requireFieldsarray

    Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `cid` o `street`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un luogo che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.

  • websiteenum

    Filtra i luoghi in base al fatto che indichino un sito web: allPlaces (predefinito), withWebsite (solo i luoghi che hanno un sito web) o withoutWebsite (solo quelli senza). Omettilo, o invia allPlaces, per restare sul prezzo più basso; withWebsite e withoutWebsite instradano a una fonte più cara.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

each itemdata.items[]

Matching Google Maps place records. Populated whenever the provider has data for the entity.

  • addressstring

    612 W 6th St, Austin, TX 78701, USA

    Full formatted street address.

  • categoriesstring[]

    Every Google Maps category listed for the place.

  • categorystring

    Coffee shop

    Primary place category (e.g. Coffee shop).

  • cidstringpuò richiedere

    8234917364550128200

    Google customer/place id (cid).

  • citystringpuò richiedere

    Austin

    City the place is in.

  • countryCodestringpuò richiedere

    US

    Two-letter country code.

  • hoursobject[]può richiedere

    Opening hours by day: each element is an object with the day name and its hours. null when the serving source does not return hours; name `hours` in `requireFields` to be served by one that does.

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no

    Primary place photo URL.

  • latitudenumber

    30.2687

    Latitude of the place in decimal degrees.

  • longitudenumber

    -97.7469

    Longitude of the place in decimal degrees.

  • namestring

    Mañana Coffee House

    Place name. Populated whenever the provider has data for the entity.

  • permanentlyClosedbooleanpuò richiedere

    false

    True when the place is marked permanently closed.

  • phonestring

    +1 512-555-0142

    Business phone number in E.164 format, when listed.

  • placeIdstring

    ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.

  • postalCodestringpuò richiedere

    78701

    Postal code of the place.

  • priceLevelstringpuò richiedere

    $$

    Relative price level indicator (e.g. $, $10-20).

  • ratingnumber

    4.6

    Average star rating out of 5.

  • reviewCountnumber

    1284

    Total number of reviews.

  • statestringpuò richiedere

    Texas

    State or region the place is in.

  • streetstringpuò richiedere

    612 W 6th St

    Street line of the address.

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.

  • websitestring

    https://mananacoffeeaustin.com

    The place's own website URL, when listed.

top level
  • foundboolean

    true

    True when the search returned at least one matching place.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

Vendi questa API? Consulta lo schema completo che il tuo endpoint deve restituire.

FAQ

Sull'API Google Maps Ricerca

L'API Google Maps Ricerca di AnyAPI restituisce dati Google Maps come JSON normalizzato da una sola chiamata POST a /v1/run/maps.search. Cerca su Google Maps luoghi che corrispondono a una query e a una località: fino a 20 record di luoghi normalizzati con valutazioni, indirizzi e contatti di base per richiesta. AnyAPI instrada ogni richiesta su 9 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 1,40 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 100,0% delle chiamate Google Maps Ricerca tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,8 secondi su 79.600 chiamate misurate.

Costa da 1,40 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

Cerca su Google Maps luoghi che corrispondono a una query e a una località: fino a 20 record di luoghi normalizzati con valutazioni, indirizzi e contatti di base per richiesta. La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Negli ultimi 30 giorni, il 100,0% delle chiamate Google Maps Ricerca tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,8 secondi su 79.600 chiamate misurate. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 71 chiamate Google Maps Ricerca a 0,0014 USD ciascuna.

AnyAPI interroga la successiva delle sue 9 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/maps.search con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.