API para Google Maps: Buscar nas proximidades

Busque no Google Maps em torno de uma latitude e longitude exatas e receba até 20 locais normalizados por chamada, cada um com o endereço dividido em rua, cidade, estado, código postal e país. Use quando você tiver coordenadas e quiser o viewport do mapa centralizado nelas; use maps.search quando tiver apenas o nome de um local. Envie o nextCursor retornado de volta como cursor para obter os próximos 20 locais.

POST/v1/run/maps.search_nearby

Disponibilidade

100,00%

30d · 363 chamadas

Requisições

363

30d

Resposta

4,1s

mediana · 30d

Preços

Um preço, em dólares

Provedores

Chameleon363 atendidas99,73% de disponibilidade3988ms p5099,73% (364 chamadas)3988ms (363 chamadas)363US$ 1,30/mil req.preço fixo

Teste

Faça sua primeira requisição

coordinates*stringO centro exato do mapa em torno do qual buscar. Use maps.search se você tiver apenas o nome de um local.query*stringO que você digitaria na barra de busca do Google Maps (ex.: coffee shop).cursorstringCursor opaco vindo do nextCursor de uma resposta anterior. Envie-o de volta para obter a próxima página de locais.languagestringCódigo de idioma de duas letras para os resultados (ex.: en).limitinteger 1-20Número máximo de locais a retornar nesta resposta (1-20). O Google Maps retorna um viewport de cerca de 20 locais por chamada; pagine com cursor para obter mais. O preço é fixo por requisição.zoomnumber 3-21Zoom do viewport do Google Maps. Valores menores cobrem uma área maior; maiores focam mais de perto em torno das coordenadas.

Abrir emPrompt copiado

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",
        "cid": "a1b2c3d4",
        "city": "San Francisco",
        "countryCode": "US",
        "description": "A short example description of this item.",
        "domain": "example.com",
        "image": "https://example.com/image.jpg",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "name": "Example title",
        "neighborhood": "example",
        "phone": "+1 555-0142",
        "placeId": "a1b2c3d4",
        "postalCode": "94107",
        "rank": 1,
        "rating": 4.6,
        "reviewCount": 12500,
        "state": "CA",
        "street": "123 Main St",
        "url": "https://example.com/page",
        "website": "https://example.com/page"
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}

Interface da resposta

interface MapsSearchNearbyResponse {
  data: {
    items: {
      address?: string;
      categories?: string[];
      category?: string;
      cid?: string;
      city?: string;
      countryCode?: string;
      description?: string;
      domain?: string;
      image?: string;
      latitude?: number;
      longitude?: number;
      name: string;
      neighborhood?: string;
      phone?: string;
      placeId: string;
      postalCode?: string;
      rank?: number;
      rating?: number;
      reviewCount?: number;
      state?: string;
      street?: string;
      url: string;
      website?: string;
    }[];
    nextCursor?: string | null;
  } | 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.search_nearby

curl -X POST https://api.getanyapi.com/v1/run/maps.search_nearby \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"coordinates":{"latitude":30.2672,"longitude":-97.7431},"limit":20,"query":"coffee shop"}'

Campo	Tipo	Valor de exemplo
Corpo da requisição
coordinates	string	{"latitude":30.2672,"longitude":-97.7431}O centro exato do mapa em torno do qual buscar. Use maps.search se você tiver apenas o nome de um local.
query	string	"coffee shop"O que você digitaria na barra de busca do Google Maps (ex.: coffee shop).
cursor	string	Cursor opaco vindo do nextCursor de uma resposta anterior. Envie-o de volta para obter a próxima página de locais.
language	string	Código de idioma de duas letras para os resultados (ex.: en).
limit	integer	20Número máximo de locais a retornar nesta resposta (1-20). O Google Maps retorna um viewport de cerca de 20 locais por chamada; pagine com cursor para obter mais. O preço é fixo por requisição.
zoom	number	Zoom do viewport do Google Maps. Valores menores cobrem uma área maior; maiores focam mais de perto em torno das coordenadas.
Resposta
data	object	The result wrapper, or null when nothing matched.
data.items	object[]	Matching Google Maps place records, nearest the requested coordinates first. Populated whenever the provider has data for the entity.
data.items[].address	string	Full formatted street address.
data.items[].categories	string[]	Every Google Maps category listed for the place.
data.items[].category	string	Primary place category (e.g. Coffee shop).
data.items[].cid	string	Google customer/place id (cid).
data.items[].city	string	City the place is in.
data.items[].countryCode	string	Two-letter country code.
data.items[].description	string	Google's one-line description of the place.
data.items[].domain	string	Registrable domain of the place website.
data.items[].image	string	Thumbnail photo URL for the place.
data.items[].latitude	number	Latitude of the place in decimal degrees.
data.items[].longitude	number	Longitude of the place in decimal degrees.
data.items[].name	string	Place name. Populated whenever the provider has data for the entity.
data.items[].neighborhood	string	Neighborhood the place is in.
data.items[].phone	string	Business phone number, when listed.
data.items[].placeId	string	Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.
data.items[].postalCode	string	Postal code of the place.
data.items[].rank	integer	One-based position of the place in the Google Maps result order.
data.items[].rating	number	Average Google rating out of 5.
data.items[].reviewCount	integer	Number of Google reviews the place has.
data.items[].state	string	State or region the place is in, spelled in full (e.g. Texas).
data.items[].street	string	Street line of the address.
data.items[].url	string	Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.
data.items[].website	string	The place's own website URL, when listed.
data.nextCursor	string	Opaque cursor for the next page of places, or null when this search is complete. Pass it back as cursor to continue.
found	boolean	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.
Preço
Preço por requisição	USD	US$ 0,0013
Preço /mil req.	USD	US$ 1,30

Dúvidas frequentes

Sobre o endpoint Buscar nas proximidades da API para Google Maps

O endpoint Buscar nas proximidades da AnyAPI para Google Maps retorna dados de Google Maps em JSON normalizado com uma chamada POST para /v1/run/maps.search_nearby. Busque no Google Maps em torno de uma latitude e longitude exatas e receba até 20 locais normalizados por chamada, cada um com o endereço dividido em rua, cidade, estado, código postal e país. Use quando você tiver coordenadas e quiser o viewport do mapa centralizado nelas; use maps.search quando tiver apenas o nome de um local. Envie o nextCursor retornado de volta como cursor para obter os próximos 20 locais. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 1,30 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar nas proximidades da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,1 segundos, em 363 chamadas medidas.

Custa a partir de US$ 1,30 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.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar nas proximidades da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,1 segundos, em 363 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.Locala partir de US$ 1,75 /mil req.Avaliaçõesa partir de US$ 3,50 /mil req.Buscara partir de US$ 1,75 /mil req.

Uma chave, uma carteira e
sua primeira chamada de Google Maps.

Ganhe ~150 requisições grátis

API para Google Maps: Buscar nas proximidades

Um preço, em dólares

Faça sua primeira requisição

Requisição, resposta e preço

Sobre o endpoint Buscar nas proximidades da API para Google Maps

Quanto custa o endpoint Buscar nas proximidades da API para Google Maps?

O que o endpoint Buscar nas proximidades da API para Google Maps retorna?

Quão confiável é o endpoint Buscar nas proximidades da API para Google Maps?

Outros endpoints de Google Maps

Uma chave, uma carteira esua primeira chamada de Google Maps.

Uma chave, uma carteira e
sua primeira chamada de Google Maps.