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.

POST/v1/run/maps.place
Disponibilidade
100,00%
30d · 21.769 chamadas
Requisições
21.770
30d · semanal, últimas 12 sem.
Resposta
2,7s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Provedores
LynxTentado primeiro21.642 atendidas100,00% de disponibilidade2545ms p5099,4%US$ 1,75/mil req.preço fixoMeerkat100 atendidas100,00% de disponibilidade1569ms p500,5%US$ 2,97/mil req.preço fixoOctopus24 atendidas100,00% de disponibilidade17248ms p500,1%US$ 4,95/mil resultadosaté US$ 0,0099 / requisição

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `hours` ou `plusCode`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um local que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
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.
{
  "data": {
    "items": [
      {
        "address": "123 Main St",
        "categories": [
          "example"
        ],
        "category": "general",
        "city": "San Francisco",
        "countryCode": "US",
        "hours": [
          {}
        ],
        "image": "https://example.com/image.jpg",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "name": "Example title",
        "neighborhood": "example",
        "permanentlyClosed": false,
        "phone": "+1 555-0142",
        "placeId": "a1b2c3d4",
        "plusCode": "a1b2c3d4",
        "postalCode": "94107",
        "priceLevel": "19.99",
        "rating": 4.6,
        "reviewsCount": 12500,
        "state": "CA",
        "street": "123 Main St",
        "url": "https://example.com/page",
        "website": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface MapsPlaceResponse {
  data: {
    items: {
      address?: string;
      categories?: string[];
      category?: string;
      city?: string;
      countryCode?: string;
      hours?: {
      }[];
      image?: string;
      latitude?: number;
      longitude?: number;
      name: string;
      neighborhood?: string;
      permanentlyClosed?: boolean;
      phone?: string;
      placeId?: string;
      plusCode?: string;
      postalCode?: string;
      priceLevel?: string;
      rating?: number;
      reviewsCount?: number;
      state?: string;
      street?: string;
      url: string;
      website?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/maps.place
curl -X POST https://api.getanyapi.com/v1/run/maps.place \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"San Francisco, CA","query":"Blue Bottle Coffee"}'
CampoTipoValor de exemplo
Corpo da requisição
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).
categoryFilterWordsarrayLista 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.
languagestringCó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.
placeMinimumStarsenumCorresponde 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.
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `hours` ou `plusCode`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um local que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
websiteenumFiltra 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.
Resposta
dataobject
data.itemsobject[]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.
data.items[].addressstringFull formatted street address. Populated whenever the provider has data for the entity.
data.items[].categoriesstring[]Every Google Maps category listed for the place.
data.items[].categorystringPrimary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.
data.items[].citypode ser exigidostring
data.items[].countryCodepode ser exigidostringTwo-letter country code.
data.items[].hourspode ser exigidoobject[]Opening hours by day: each element is an object with the day name and its hours.
data.items[].imagestringURL of the primary place photo.
data.items[].latitudenumberPopulated whenever the provider has data for the entity.
data.items[].longitudenumberPopulated whenever the provider has data for the entity.
data.items[].namestringBusiness or place name. Populated whenever the provider has data for the entity.
data.items[].neighborhoodpode ser exigidostring
data.items[].permanentlyClosedpode ser exigidobooleanWhether the place is permanently closed.
data.items[].phonestringFormatted phone number.
data.items[].placeIdstringGoogle Maps place id. Populated whenever the provider has data for the entity.
data.items[].plusCodepode ser exigidostringGoogle Plus Code for the location.
data.items[].postalCodepode ser exigidostring
data.items[].priceLevelstringPrice level indicator (e.g. a price range).
data.items[].ratingnumberAverage star rating.
data.items[].reviewsCountintegerTotal number of reviews.
data.items[].statepode ser exigidostringState or region name.
data.items[].streetpode ser exigidostringStreet portion of the address.
data.items[].urlstringGoogle Maps URL for the place. Populated whenever the provider has data for the entity.
data.items[].websitestringBusiness website URL.
foundboolean
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.
Preço
Preço por requisiçãoUSDUS$ 0,00175
Preço /mil req.USDUS$ 1,75

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 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,75 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,7 segundos, em 21.769 chamadas medidas.

Custa a partir de US$ 1,75 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,7 segundos, em 21.769 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.
Mais para chamar

Outros endpoints de Google Maps

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