API para Google Maps

API para Google Maps: Local

Consulte um local no Google Maps por nome ou termo de busca (opcionalmente restrito a uma localização) e receba o local mais compatível, com os dados disponíveis de endereço, contato, nota e coordenadas, em JSON normalizado.

Comece grátisBaixar amostraou JSON

US$ 1,00/mil req., pague por requisição, sem assinatura.

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
O que a API retornouitems[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 campos a mais
}
Disponibilidade
100,00%
30d · 150.371 chamadas
Requisições
150.391
30d · semanal, últimas 12 sem.
Resposta
2,5s
mediana · 30d

Preços e provedores

Preços do endpoint Local da API para Google Maps: uma API, 4 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Provedor
1LynxAtende primeiro98,82% de disponibilidade2387ms p5091,1% das chamadasUS$ 1,00/mil req.flat2BadgerReserva 195,48% de disponibilidade2818ms p503,9% das chamadasUS$ 1,50/mil req.flat3MeerkatReserva 299,76% de disponibilidade1230ms p505,0% das chamadasUS$ 2,97/mil req.flat4OctopusReserva 3100,00% de disponibilidade14132ms p500,0% das chamadasUS$ 4,95/mil resultadosaté US$ 0,0099 / requisição
Você paga
US$ 10,00
US$ 1,00/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 100 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Local do Google Maps em uma só requisição

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.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.

Este exemplo mostra 26 de 27 campos. Ver todos os campos

{
  "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"
          }
        ]
      }
    ]
  }
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • querystring

    Blue Bottle Coffee

    O nome da empresa ou texto de busca a consultar, como você digitaria na barra de busca do Google Maps (ex.: Blue Bottle Coffee).

  • categoryFilterWordsarray

    Lista opcional de nomes de categoria de local do Google Maps a manter; a correspondência fica limitada a um local cuja categoria seja uma delas. Use os nomes de categoria em minúsculas, como aparecem no Google Maps (ex.: ["coffee shop"]). Omita para permitir qualquer categoria e ficar no preço mais barato; um filtro de categoria direciona para uma fonte mais cara.

  • languagestring

    Código de idioma de duas letras para os detalhes do resultado (ex.: en).

  • locationstring

    San Francisco, CA

    Localização opcional em texto livre para restringir a busca, de preferência cidade e estado ou país (ex.: San Francisco, CA). Restringe a consulta à melhor correspondência nessa área.

  • placeMinimumStarsenum

    Corresponde apenas a um local com pelo menos esta nota média: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) ou fourAndHalf (4.5+). Locais sem avaliações são excluídos. Omita este campo para ficar no preço mais barato; uma nota mínima direciona para uma fonte mais 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 conforme o local liste ou não um site: allPlaces (padrão), withWebsite (apenas se tiver site) ou withoutWebsite (apenas se não tiver). Omita este campo, ou envie allPlaces, para ficar no preço mais barato; withWebsite e withoutWebsite direcionam para uma fonte mais cara.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

each itemdata.items[]

The best-matching place for the query, with available address, contact, category, rating, opening-hours, and coordinate details. Up to one element (empty when nothing matched). Populated whenever the provider has data for the entity.

  • addressstring

    66 Mint St, San Francisco, CA 94103, USA

    Full formatted street address. Populated whenever the provider has data for the entity.

  • categoriesstring[]

    Every Google Maps category listed for the place.

  • categorystring

    Coffee shop

    Primary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.

  • citystringpode ser exigido

    San Francisco

  • countryCodestringpode ser exigido

    US

    Two-letter country code.

  • hoursobject[]

    Opening hours by day: each element is an object with the day name and its hours.

  • imagestring

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

    URL of the primary place photo.

  • latitudenumber

    37.7825

    Populated whenever the provider has data for the entity.

  • longitudenumber

    -122.4058

    Populated whenever the provider has data for the entity.

  • namestring

    Blue Bottle Coffee

    Business or place name. Populated whenever the provider has data for the entity.

  • neighborhoodstringpode ser exigido

    SoMa

  • permanentlyClosedbooleanpode ser exigido

    false

    Whether the place is permanently closed.

  • phonestring

    +1 415-555-0118

    Formatted phone number.

  • placeIdstring

    ChIJd7DoQL2AhYARW-mNQFPuGZo

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

  • plusCodestringpode ser exigido

    QHGX+59 San Francisco, California

    Google Plus Code for the location.

  • postalCodestringpode ser exigido

    94103

  • priceLevelstring

    $$

    Price level indicator (e.g. a price range).

  • ratingnumber

    4.4

    Average star rating.

  • reviewsCountinteger

    2937

    Total number of reviews.

  • statestringpode ser exigido

    California

    State or region name.

  • streetstringpode ser exigido

    66 Mint St

    Street portion of the address.

  • urlstring

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

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

  • websitestring

    https://bluebottlecoffee.com

    Business website URL.

top level
  • foundboolean

    true

  • 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.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Dúvidas frequentes

Sobre o endpoint Local da API para Google Maps

O endpoint Local da AnyAPI para Google Maps retorna dados de Google Maps em JSON normalizado com uma chamada POST para /v1/run/maps.place. Consulte um local no Google Maps por nome ou termo de busca (opcionalmente restrito a uma localização) e receba o local mais compatível, com os dados disponíveis de endereço, contato, nota e coordenadas, em JSON normalizado. A AnyAPI distribui cada requisição entre 4 fontes, com failover automático quando uma falha. Custa a partir de US$ 1 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Local da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,5 segundos, em 150.371 chamadas medidas.

Custa a partir de US$ 1 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Consulte um local no Google Maps por nome ou termo de busca (opcionalmente restrito a uma localização) e receba o local mais compatível, com os dados disponíveis de endereço, contato, nota e coordenadas, em JSON normalizado. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Local da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,5 segundos, em 150.371 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 100 chamadas de Local do Google Maps a US$ 0,001 cada.

A AnyAPI consulta a próxima das suas 4 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/maps.place com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.
Mais para chamar

Outros endpoints de Google Maps

Contatosa partir de US$ 3,25 /mil req.Avaliaçõesa partir de US$ 0,0215 /mil resultadosBuscara partir de US$ 1,50 /mil req.Buscar nas proximidadesa partir de US$ 1,30 /mil req.