API di Google Maps

Google Maps Luogo API

Cerca un luogo su Google Maps per nome o query di ricerca (facoltativamente limitata a una località) e ottieni il luogo più corrispondente con indirizzo, contatti, valutazione e coordinate disponibili come JSON normalizzato.

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

Blue Bottle Coffee - Google Maps
google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
DirectionsSaveNearbySend to phoneShare

Blue Bottle Coffee

4.4(2,937)·Coffee shop

66 Mint St, San Francisco, CA 94103, USA
Open · Monday 6:30 AM-6:00 PM
+1 415-555-0118
bluebottlecoffee.com
OverviewReviewsAbout
Cosa ha restituito l'APIitems[0]
{
"name": "Blue Bottle Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
"placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
"address": "66 Mint St, San Francisco, CA 94103, USA",
"street": "66 Mint St",
"city": "San Francisco",
"state": "California",
"postalCode": "94103",
+15 campi in più
}
Disponibilità
100,00%
30d · 55.527 chiamate
Richieste
55.528
30 g · settimanale, ultime 12 sett.
Risposta
3,0s
mediana · 30d

Provalo

Ottieni Google Maps Luogo in una sola richiesta

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.
{
  "found": true,
  "data": {
    "items": [
      {
        "name": "Blue Bottle Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "address": "66 Mint St, San Francisco, CA 94103, USA",
        "street": "66 Mint St",
        "city": "San Francisco",
        "state": "California",
        "postalCode": "94103",
        "countryCode": "US",
        "neighborhood": "SoMa",
        "phone": "+1 415-555-0118",
        "website": "https://bluebottlecoffee.com",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Cafe",
          "Espresso bar"
        ],
        "rating": 4.4,
        "reviewsCount": 2937,
        "latitude": 37.7825,
        "longitude": -122.4058,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no",
        "priceLevel": "$$",
        "plusCode": "QHGX+59 San Francisco, California",
        "permanentlyClosed": false,
        "hours": [
          {
            "day": "Monday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Tuesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Wednesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Thursday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Friday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Saturday",
            "hours": "7:00 AM-6:00 PM"
          },
          {
            "day": "Sunday",
            "hours": "7:00 AM-5:00 PM"
          }
        ]
      }
    ]
  }
}

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-10-07 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

  • querystring

    Blue Bottle Coffee

    Nome dell'attività o testo di ricerca da cercare, come lo digiteresti nella barra di ricerca di Google Maps (es. Blue Bottle Coffee).

  • categoryFilterWordsarray

    Elenco facoltativo di nomi di categorie dei luoghi di Google Maps da mantenere; la corrispondenza è limitata a un luogo la cui categoria è una di queste. Usa i nomi delle categorie in minuscolo come mostrati su Google Maps (es. ["coffee shop"]). Omettilo per consentire qualsiasi categoria e restare sul prezzo più basso; un filtro per categoria instrada a una fonte più cara.

  • languagestring

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

  • locationstring

    San Francisco, CA

    Località in testo libero facoltativa per delimitare la ricerca, meglio se città più stato o paese (es. San Francisco, CA). Restringe la query alla corrispondenza migliore in quell'area.

  • placeMinimumStarsenum

    Cerca solo 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

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • websiteenum

    Filtra in base al fatto che il luogo indichi un sito web: allPlaces (predefinito), withWebsite (solo se ha un sito web) o withoutWebsite (solo se non ne ha). 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.

  • foundboolean

    true

each itemdata.items[]
  • namestring

    Blue Bottle Coffee

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo

  • placeIdstring

    ChIJd7DoQL2AhYARW-mNQFPuGZo

  • addressstring

    66 Mint St, San Francisco, CA 94103, USA

  • streetstringpuò richiedere

    66 Mint St

  • citystringpuò richiedere

    San Francisco

  • statestringpuò richiedere

    California

  • postalCodestringpuò richiedere

    94103

  • countryCodestringpuò richiedere

    US

  • neighborhoodstringpuò richiedere

    SoMa

  • phonestring

    +1 415-555-0118

  • websitestring

    https://bluebottlecoffee.com

  • categorystring

    Coffee shop

  • categories[]string

    Coffee shop

  • ratingnumber

    4.4

  • reviewsCountnumber

    2937

  • latitudenumber

    37.7825

  • longitudenumber

    -122.4058

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no

  • priceLevelstring

    $$

  • plusCodestringpuò richiedere

    QHGX+59 San Francisco, California

  • permanentlyClosedbooleanpuò richiedere

    false

each hourdata.items[].hours[]
  • daystring

    Monday

  • hoursstring

    6:30 AM-6:00 PM

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

FAQ

Sull'API Google Maps Luogo

L'API Google Maps Luogo di AnyAPI restituisce dati Google Maps come JSON normalizzato da una sola chiamata POST a /v1/run/maps.place. Cerca un luogo su Google Maps per nome o query di ricerca (facoltativamente limitata a una località) e ottieni il luogo più corrispondente con indirizzo, contatti, valutazione e coordinate disponibili come JSON normalizzato. AnyAPI instrada ogni richiesta su 3 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 1,75 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 Luogo tramite AnyAPI è riuscito, con un tempo di risposta mediano di 3,0 secondi su 55.527 chiamate misurate.

Costa da 1,75 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 un luogo su Google Maps per nome o query di ricerca (facoltativamente limitata a una località) e ottieni il luogo più corrispondente con indirizzo, contatti, valutazione e coordinate disponibili come JSON normalizzato. 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 Luogo tramite AnyAPI è riuscito, con un tempo di risposta mediano di 3,0 secondi su 55.527 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 57 chiamate Google Maps Luogo a 0,00175 USD ciascuna.

AnyAPI interroga la successiva delle sue 3 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.place 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.