Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar o serviço web da API do Google Places

Para começar, orientaremos você pelo Console do Desenvolvedor do Google para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar o serviço web da API do Google Places
  3. Criar chaves apropriadas
Continuar

Place Search

A Google Places API Web Service permite consultar informações de locais em uma variedade de categorias, como estabelecimentos, pontos de interesse proeminentes, localizações geográficas e muito mais. É possível pesquisar locais por proximidade ou com uma string de texto. Uma Place Search retorna uma lista de locais com informações resumidas sobre cada local; informações adicionais estão disponíveis em uma consulta Place Details.

Solicitações Nearby Search

Versões anteriores da Places API chamavam Nearby Search de Place Search.

Uma Nearby Search permite pesquisas de locais dentro de uma área específica. Você pode refinar a solicitação de pesquisa fornecendo palavras-chave ou especificando o tipo de local que está procurando.

A Nearby Search request is an HTTP URL of the following form:

https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters

em que output pode ser um dos seguintes valores:

  • json (recomendado) indica a saída em JavaScript Object Notation (JSON)
  • xml indica a saída como XML

Certos parâmetros são obrigatórios para iniciar uma solicitação Nearby Search. Como é padrão em URLs, todos os parâmetros são separados usando o caractere E comercial (&).

Parâmetros obrigatórios

  • key — a chave de API do aplicativo. Essa chave identifica o aplicativo para fins de gerenciamento de cotas e de forma que locais adicionados a partir dele sejam imediatamente disponibilizados para o aplicativo. Consulte Obter uma chave para saber mais.
  • location — a latitude/longitude em torno da qual você deseja recuperar informações de local. Deve ser especificado como latitude,longitude.
  • radius — define a distância (em metros) dentro da qual deve-se retornar resultados de local. O raio máximo permitido é de 50.000 metros. Observe que radius não deve ser incluído se rankby=distance (descrito em Parâmetros opcionais abaixo) for especificado.
  • Se rankby=distance descrito a seguir em Parâmetros opcionais) for especificado, será necessário especificar um ou mais dos parâmetros keyword, name ou type.

Parâmetros opcionais

  • keyword — um termo para corresponder a todo conteúdo que o Google tiver indexado para esse local, incluindo nome, tipo e endereço, bem como avaliações de clientes e conteúdo de terceiros, sem limitação.
  • language — o código de idioma, indicando em que idioma os resultados devem ser retornados, se possível. As pesquisas também dão preferência ao idioma selecionado. Os resultados no idioma selecionado receberão uma classificação mais alta. Consulte a lista de idiomas permitidos e seus códigos. Observe que atualizamos com frequência os idiomas suportados, portanto, essa lista pode não estar completa.
  • minprice e maxprice (opcional) — restringe os resultados apenas a locais dentro da faixa especificada. Valores válidos estão no intervalo de 0 (mais barato) a 4 (mais caro), inclusive. O valor exato indicado por um valor especifico variará de região para região.
  • name — um termo a ser correspondido em todo o conteúdo indexado pelo Google para o local. Equivalente a keyword. O campo name não é mais restrito a nomes de local. Os valores desse campo são combinados com valores no campo keyword e passados como parte da mesma string de pesquisa. Recomendamos usar apenas o parâmetro keyword para todos os termos de pesquisa.
  • opennow — retorna somente aqueles locais que estão abertos para funcionamento no momento em que a consulta é enviada. Locais que não especificam horário de funcionamento no banco de dados do Google Places não serão retornados ao incluir esse parâmetro na consulta.
  • rankby — especifica a ordem em que os resultados são listados. Observe que rankby não deverá ser incluído se radius (descrito acima em Parâmetros obrigatórios) for especificado. Os valores possíveis são:
    • prominence (padrão). Essa opção classifica os resultados com base na importância. A classificação dará preferência a locais proeminentes dentro da área especificada. A proeminência pode ser afetada pela classificação de um local no índice do Google, pela popularidade global e outros fatores.
    • distance Essa opção direciona os resultados em ordem crescente de distância a partir da location especificada. Quando distance é especificada, será necessário especificar um ou mais dos parâmetroskeyword, name ou type.
  • type — restringe os resultados a locais que correspondam ao tipo especificado. Só um tipo pode ser especificado (se mais de um tipo for fornecido, todos os seguintes após a primeira entrada serão ignorados). Consulte a lista de tipos permitidos.
  • types (obsoleto) — restringe os resultados a locais que correspondam a pelo menos um dos tipos especificados. Separe os tipos com uma barra vertical, da seguinte forma:
    type1|type2|etc.
  • pagetoken — retorna os próximos 20 resultados de uma pesquisa executada anteriormente. Configurar um parâmetro pagetoken executará uma pesquisa com os mesmos parâmetros usados anteriormente. Todos os parâmetros, exceto pagetoken, serão ignorados.
  • zagatselected (obsoleto) — adicione esse parâmetro (apenas o nome do parâmetro, sem valor associado) para restringir a pesquisa a locais que sejam negócios selecionados pela Zagat. Esse parâmetro não deve incluir um valor true ou false. O parâmetro zagatselected é experimental e só está disponível para clientes da Google Places API com uma licença do Premium Plan.

Observação para clientes do Google Maps APIs Premium Plan: É necessário incluir uma chave de API nas solicitações. Você não deve incluir um parâmetro' client ou signature nas solicitações.

Exemplo de Nearby Search

O exemplo a seguir é uma solicitação de pesquisa por locais de tipo “restaurante” dentro de uma área de 500 m de distância de um ponto em Sydney, Austrália, que contenham a palavra “cruzeiro”:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

Observação: nesse exemplo, é necessário substituir key pela sua própria chave de API para que a solicitação funcione no seu aplicativo.

Solicitações Text Search

O serviço Text Search da Google Places API é um serviço Web que retorna informações sobre um conjunto de locais com base em uma string — por exemplo, "pizza em Nova Iorque", "loja de sapatos perto de Ottawa" ou "rua Central 123". O serviço responde com uma lista de locais correspondentes à string de texto e a todos os direcionamentos de localização definidos.

O serviço é particularmente útil para executar consultas de endereço ambíguas em um sistema automatizado e componentes da string que não fazem parte do endereço podem corresponder a empresas e endereços. Entre os exemplos de consultas de endereço ambíguas, estão endereços incompletos, endereços com formatação incorreta ou uma solicitação que inclui componentes que não fazem parte do endereço, como nomes de empresas.

A resposta da pesquisa inclui uma lista de locais. É possível enviar uma solicitação de Place Details para obter mais informações sobre qualquer um dos locais dessa lista.

Os serviços de pesquisa do Google Places compartilham os mesmos limites de uso. No entanto, o serviço Text Search está sujeito a um multiplicador de 10 vezes. Ou seja, cada solicitação de Text Search que você fizer contará como 10 solicitações em relação a sua cota. Se você adquiriu a Google Places API como parte do contrato daGoogle Maps APIs Premium Plan, o multiplicador pode ser diferente. Consulte a documentação da Google Maps APIs Premium Plan para obter detalhes.

Uma solicitação Text Search é um URL HTTP com o seguinte formato:

https://maps.googleapis.com/maps/api/place/textsearch/output?parameters

em que output pode ser um dos seguintes valores:

  • json (recomendado) indica a saída em JavaScript Object Notation (JSON)
  • xml indica a saída como XML

Certos parâmetros são obrigatórios para iniciar uma solicitação de pesquisa. Como é padrão em URLs, todos os parâmetros são separados usando o caractere E comercial (&).

Parâmetros obrigatórios

  • query — a string de texto a pesquisar, por exemplo, "restaurante" ou "rua Central 123". O serviço Google Places retornará correspondências possíveis com base nessa string e ordenará os resultados com base na relevância percebida. Este parâmetro se torna opcional se o parâmetro type também for usado na solicitação de pesquisa.
  • key — a chave de API do aplicativo. Essa chave identifica o aplicativo para fins de gerenciamento de cotas e de forma que locais adicionados a partir dele sejam imediatamente disponibilizados para o aplicativo. Consulte Obter uma chave para a Google Places API Web Service para ver como criar um projeto de API e obter sua chave.

Parâmetros opcionais

  • location — a latitude/longitude em torno da qual você deseja recuperar informações de local. Deve ser especificado como latitude,longitude. Se você especificar um parâmetro location, deverá também especificar um parâmetro radius.
  • radius — define a distância (em metros) dentro da qual se deve retornar resultados de local. O raio máximo permitido é de 50.000 metros. Os resultados dentro dessa região terão classificação mais alta que resultados fora do círculo da pesquisa; no entanto, resultados proeminentes fora do raio de pesquisa poderão ser incluídos.
  • language — o código de idioma, indicando em que idioma os resultados devem ser retornados, se possível. As pesquisas também dão preferência ao idioma selecionado. Os resultados no idioma selecionado receberão uma classificação mais alta. Consulte a lista de idiomas permitidos e seus códigos. Observe que atualizamos com frequência os idiomas permitidos, portanto, essa lista pode não estar completa.
  • minprice e maxprice (opcional) — restringe os resultados apenas a locais dentro do nível de preço especificado. Valores válidos estão no intervalo de 0 (mais barato) a 4 (mais caro), inclusive. O valor exato indicado por um valor especifico variará de região para região.
  • opennow — retorna somente aqueles locais que estão abertos para funcionamento no momento em que a consulta é enviada. Locais que não especificam horário de funcionamento no banco de dados do Google Places não serão retornados se esse parâmetro for incluído na consulta.
  • pagetoken — retorna os próximos 20 resultados de uma pesquisa executada anteriormente. Configurar um parâmetro pagetoken executará uma pesquisa com os mesmos parâmetros usados anteriormente. Todos os parâmetros, exceto pagetoken, serão ignorados.
  • type — restringe os resultados a locais que correspondam ao tipo especificado. Só um tipo pode ser especificado (se mais de um tipo for fornecido, todos os seguintes após a primeira entrada serão ignorados). Consulte a lista de tipos permitidos.
  • types (obsoleto) — restringe os resultados a locais que correspondam a pelo menos um dos tipos especificados. Separe os tipos com uma barra vertical (type1|type2|etc).
  • zagatselected (obsoleto) — adicione esse parâmetro (apenas o nome do parâmetro, sem valor associado) para restringir a pesquisa a locais que sejam negócios selecionados pela Zagat. Esse parâmetro não deve incluir um valor true ou false. O parâmetro zagatselected é experimental e só está disponível para clientes da Google Places API com uma licença do Premium Plan.

Você pode direcionar resultados para um círculo especificado passando os parâmetros location e radius. Isso instruirá o serviço Google Places a exibir, preferivelmente, os resultados dentro daquele círculo. Os resultados fora da área definida ainda poderão ser exibidos.

Observação para clientes do Google Maps APIs Premium Plan: É necessário incluir uma chave de API nas solicitações. Você não deve incluir um parâmetro' client ou signature nas solicitações.

Exemplos de pesquisa de texto

Observação: nesses exemplos, é necessário substituir key pela sua própria chave de API para que a solicitação funcione no seu aplicativo.

Exemplo 1: o exemplo a seguir mostra uma pesquisa por restaurantes pertos de Sydney.

https://maps.googleapis.com/maps/api/place/textsearch/xml?query=restaurants+in+Sydney&key=YOUR_API_KEY

Exemplo 2: o exemplo a seguir mostra uma pesquisa por endereço incompleto que não inclui cidade, estado e país.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&key=YOUR_API_KEY

Exemplo 3: o exemplo a seguir mostra uma pesquisa pelo mesmo endereço incompleto do exemplo 2, mas inclui os parâmetros location e radius para direcionar os resultados a uma região de interesse. Compare os resultados do exemplo 2 e do exemplo 3.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=123+main+street&location=42.3675294,-71.186966&radius=10000&key=YOUR_API_KEY

Solicitações Radar Search

O serviço Radar Search da Google Places API permite pesquisar até 200 locais de uma vez, mas com menos detalhes do que é normalmente retornado por uma solicitação Text Search ou Nearby Search. Com Radar Search, é possível criar aplicativos que ajudem os usuários a identificar áreas de interesse específicas dentro de uma área geográfica.

A resposta da pesquisa incluirá até 200 locais e apenas uma das seguintes informações sobre cada local:

  • O campo geometry contendo as coordenadas geográficas.
  • O place_id, que você pode usar em uma solicitação de Place Details para obter mais informações sobre o local. Para saber mais sobre IDs de local, consulte a visão geral de IDs de local.
  • O campo obsoleto reference. Consulte o aviso de obsolescência nesta página.

Uma solicitação Radar Search é um URL HTTP com o seguinte formato:

https://maps.googleapis.com/maps/api/place/radarsearch/output?parameters

em que output pode ser um dos seguintes valores:

  • json (recomendado) indica a saída em JavaScript Object Notation (JSON)
  • xml indica a saída como XML

Certos parâmetros são obrigatórios para iniciar uma solicitação de pesquisa. Como é padrão em URLs, todos os parâmetros são separados usando o caractere E comercial (&).

Parâmetros obrigatórios

  • key — a chave de API do aplicativo. Essa chave identifica o aplicativo para fins de gerenciamento de cotas e de forma que locais adicionados a partir dele sejam imediatamente disponibilizados para o aplicativo. Consulte Obter uma chave para a Google Places API Web Service para ver como criar um projeto de API e obter sua chave.
  • location — a latitude/longitude em torno da qual você deseja recuperar informações de local. Deve ser especificado como latitude,longitude.
  • radius — define a distância (em metros) dentro da qual deve-se retornar resultados de local. O raio máximo permitido é de 50.000 metros.
  • As solicitações de Radar Search devem conter pelo menos um dos parâmetros keyword, name ou type.

Parâmetros opcionais

  • keyword — um termo para corresponder a todo conteúdo que o Google tiver indexado para esse local, incluindo nome, tipo e endereço, bem como avaliações de clientes e conteúdo de terceiros, sem limitação.
  • language — o código de idioma, indicando em que idioma os resultados devem ser retornados, se possível. As pesquisas também dão preferência ao idioma selecionado. Os resultados no idioma selecionado receberão uma classificação mais alta. Consulte a lista de idiomas permitidos e seus códigos. Observe que atualizamos com frequência os idiomas permitidos, portanto, essa lista pode não estar completa.
  • minprice e maxprice (opcional) — restringe os resultados apenas a locais dentro do nível de preço especificado. Valores válidos estão no intervalo de 0 (mais barato) a 4 (mais caro), inclusive. O valor exato indicado por um valor especifico variará de região para região.
  • name — um termo a ser correspondido em todo o conteúdo indexado pelo Google para o local. Equivalente a keyword. O campo name não é mais restrito a nomes de local. Os valores desse campo são combinados com valores no campo keyword e passados como parte da mesma string de pesquisa. Recomendamos usar apenas o parâmetro keyword para todos os termos de pesquisa.
  • opennow — retorna somente aqueles locais que estão abertos para funcionamento no momento em que a consulta é enviada. Locais que não especificam horário de funcionamento no banco de dados do Google Places não serão retornados se esse parâmetro for incluído na consulta.
  • type — restringe os resultados a locais que correspondam ao tipo especificado. Só um tipo pode ser especificado (se mais de um tipo for fornecido, todos os seguintes após a primeira entrada serão ignorados). Consulte a lista de tipos permitidos.
  • types (obsoleto) — restringe os resultados a locais que correspondam a pelo menos um dos tipos especificados. Separe os tipos com uma barra vertical (type1|type2|etc).
  • zagatselected (obsoleto) — adicione esse parâmetro (apenas o nome do parâmetro, sem valor associado) para restringir a pesquisa a locais que sejam negócios selecionados pela Zagat. Esse parâmetro não deve incluir um valor true ou false. O parâmetro zagatselected é experimental e só está disponível para clientes da Google Places API com uma licença do Premium Plan.

Observação para clientes do Google Maps APIs Premium Plan: É necessário incluir uma chave de API nas solicitações. Você não deve incluir um parâmetro' client ou signature nas solicitações.

Exemplos de Radar Search

Observação: nesses exemplos, é necessário substituir key pela sua própria chave de API para que a solicitação funcione no seu aplicativo.

Exemplo 1: o exemplo a seguir retorna uma lista de museus perto de Londres, Inglaterra.

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=51.503186,-0.126446&radius=5000&type=museum&key=YOUR_API_KEY

Exemplo 2: você pode executar consultas mais precisas usando uma combinação dos parâmetros keyword e type. O exemplo a seguir mostra restaurantes e cafés em Paris descritos como vegetarianos pelos usuários.

https://maps.googleapis.com/maps/api/place/radarsearch/json?location=48.859294,2.347589&radius=5000&type=cafe&keyword=vegetarian&key=YOUR_API_KEY

Respostas da pesquisa

As respostas da pesquisa são retornadas no formato indicado pelo sinalizador output dentro do caminho da solicitação de URL.

O exemplo abaixo mostra uma resposta de Nearby Search. Uma resposta de Text Search é similar, exceto por retornar um formatted_address em vez de uma propriedade vicinity. Uma Radar Search inclui apenas campos limitados, conforme descrito acima.

JSON
{
   "html_attributions" : [],
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870775,
               "lng" : 151.199025
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "21a0b251c9b8392186142c798263e289fe45b4aa",
         "name" : "Rhythmboat Cruises",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 270,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAF-LjFR1ZV93eawe1cU_3QNMCNmaGkowY7CnOf-kcNmPhNnPEG9W979jOuJJ1sGr75rhD5hqKzjD8vbMbSsRnq_Ni3ZIGfY6hKWmsOf3qHKJInkm4h55lzvLAXJVc-Rr4kI9O1tmIblblUpg2oqoq8RIQRMQJhFsTr5s9haxQ07EQHxoUO0ICubVFGYfJiMUPor1GnIWb5i8",
               "width" : 519
            }
         ],
         "place_id" : "ChIJyWEHuEmuEmsRm9hTkapTCrk",
         "scope" : "GOOGLE",
         "alt_ids" : [
            {
               "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
               "scope" : "APP"
            }
         ],
         "reference" : "CoQBdQAAAFSiijw5-cAV68xdf2O18pKIZ0seJh03u9h9wk_lEdG-cP1dWvp_QGS4SNCBMk_fB06YRsfMrNkINtPez22p5lRIlj5ty_HmcNwcl6GZXbD2RdXsVfLYlQwnZQcnu7ihkjZp_2gk1-fWXql3GQ8-1BEGwgCxG-eaSnIJIBPuIpihEhAY1WYdxPvOWsPnb2-nGb6QGhTipN0lgaLpQTnkcMeAIEvCsSa0Ww",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "Pyrmont Bay Wharf Darling Dr, Sydney"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866891,
               "lng" : 151.200814
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "45a27fd8d56c56dc62afc9b49e1d850440d5c403",
         "name" : "Private Charter Sydney Habour Cruise",
         "photos" : [
            {
               "height" : 426,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAL3n0Zu3U6fseyPl8URGKD49aGB2Wka7CKDZfamoGX2ZTLMBYgTUshjr-MXc0_O2BbvlUAZWtQTBHUVZ-5Sxb1-P-VX2Fx0sZF87q-9vUt19VDwQQmAX_mjQe7UWmU5lJGCOXSgxp2fu1b5VR_PF31RIQTKZLfqm8TA1eynnN4M1XShoU8adzJCcOWK0er14h8SqOIDZctvU",
               "width" : 640
            }
         ],
         "place_id" : "ChIJqwS6fjiuEmsRJAMiOY9MSms",
         "scope" : "GOOGLE",
         "reference" : "CpQBhgAAAFN27qR_t5oSDKPUzjQIeQa3lrRpFTm5alW3ZYbMFm8k10ETbISfK9S1nwcJVfrP-bjra7NSPuhaRulxoonSPQklDyB-xGvcJncq6qDXIUQ3hlI-bx4AxYckAOX74LkupHq7bcaREgrSBE-U6GbA1C3U7I-HnweO4IPtztSEcgW09y03v1hgHzL8xSDElmkQtRIQzLbyBfj3e0FhJzABXjM2QBoUE2EnL-DzWrzpgmMEulUBLGrtu2Y",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "Australia"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.870943,
               "lng" : 151.190311
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
         "id" : "30bee58f819b6c47bd24151802f25ecf11df8943",
         "name" : "Bucks Party Cruise",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAA48AX5MsHIMiuipON_Lgh97hPiYDFkxx_vnaZQMOcvcQwYN92o33t5RwjRpOue5R47AjfMltntoz71hto40zqo7vFyxhDuuqhAChKGRQ5mdO5jv5CKWlzi182PICiOb37PiBtiFt7lSLe1SedoyrD-xIQD8xqSOaejWejYHCN4Ye2XBoUT3q2IXJQpMkmffJiBNftv8QSwF4",
               "width" : 800
            }
         ],
         "place_id" : "ChIJLfySpTOuEmsRsc_JfJtljdc",
         "scope" : "GOOGLE",
         "reference" : "CoQBdQAAANQSThnTekt-UokiTiX3oUFT6YDfdQJIG0ljlQnkLfWefcKmjxax0xmUpWjmpWdOsScl9zSyBNImmrTO9AE9DnWTdQ2hY7n-OOU4UgCfX7U0TE1Vf7jyODRISbK-u86TBJij0b2i7oUWq2bGr0cQSj8CV97U5q8SJR3AFDYi3ogqEhCMXjNLR1k8fiXTkG2BxGJmGhTqwE8C4grdjvJ0w5UsAVoOH7v8HQ",
         "types" : [ "restaurant", "food", "establishment" ],
         "vicinity" : "37 Bank St, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867591,
               "lng" : 151.201196
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
         "id" : "a97f9fb468bcd26b68a23072a55af82d4b325e0d",
         "name" : "Australian Cruise Group",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 242,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAABjeoPQ7NUU3pDitV4Vs0BgP1FLhf_iCgStUZUr4ZuNqQnc5k43jbvjKC2hTGM8SrmdJYyOyxRO3D2yutoJwVC4Vp_dzckkjG35L6LfMm5sjrOr6uyOtr2PNCp1xQylx6vhdcpW8yZjBZCvVsjNajLBIQ-z4ttAMIc8EjEZV7LsoFgRoU6OrqxvKCnkJGb9F16W57iIV4LuM",
               "width" : 200
            }
         ],
         "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
         "scope" : "GOOGLE",
         "reference" : "CoQBeQAAAFvf12y8veSQMdIMmAXQmus1zqkgKQ-O2KEX0Kr47rIRTy6HNsyosVl0CjvEBulIu_cujrSOgICdcxNioFDHtAxXBhqeR-8xXtm52Bp0lVwnO3LzLFY3jeo8WrsyIwNE1kQlGuWA4xklpOknHJuRXSQJVheRlYijOHSgsBQ35mOcEhC5IpbpqCMe82yR136087wZGhSziPEbooYkHLn9e5njOTuBprcfVw",
         "types" : [ "travel_agency", "restaurant", "food", "establishment" ],
         "vicinity" : "32 The Promenade, King Street Wharf 5, Sydney"
      }
   ],
   "status" : "OK"
}

Uma resposta JSON contém até quatro elementos-raiz:

  • "status" contém os metadados da solicitação. Consulte Códigos de status abaixo.
  • "results" contém uma matriz de locais, com informações sobre cada um deles. Consulte Resultados da pesquisa para obter informações sobre esses resultados. A Places API retorna até 20 resultados de establishment por consulta. Adicionalmente, resultados political podem ser retornados, que servem para identificar a área da solicitação.
  • html_attributions contém uma série de atribuições sobre essa listagem que devem ser exibidas para o usuário.
  • next_page_token contém um token que pode ser usado para retornar até 20 resultados adicionais. Um next_page_token não será retornado se não houver resultados adicionais a exibir. O número máximo de resultados que podem ser retornados é 60. Há um breve atraso entre o momento em que um next_page_token é emitido e o momento em que ele se tornará válido.

Consulte Processar JSON com JavaScript para obter ajuda com a análise de respostas JSON.

XML
<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Rhythmboat Cruises</name>
  <vicinity>Pyrmont Bay Wharf Darling Dr, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8707750</lat>
    <lng>151.1990250</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CoQBdAAAAChhtoQX_467esHavS0Sj9DrY306W3_uDXKmB2us8Eh7_dX7rDuln18i_uqocF_LmzRptuFr6WZs7aeBSLFq8VFmckxFjsXDaqMdd3gvxi_5dIwPTEugQQYG9oJA-YnYfPBvjGtuoMfNnjyU2GuxGRmJjCO77pEAbsTLq44eBG5jEhAvkKHCGqIzqgC9tdOb1dSqGhRA1hhG4pvILD5OEAq6W8L8sXbkug</reference>
  <id>21a0b251c9b8392186142c798263e289fe45b4aa</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAiRA8ls6lx5LTfLuHJtLYvz73LXIMa5EVsHz2OUjh70LBPBnIEULZ57w076gOuyCeJqP041_v-ek3I5C4IkqW7YgA0EBybwywfIcUXsj5W_qiJR2yaXHXI-FmDM6j1zaS0sJQnNJhe4Bl9W42Jx16phIQRmNOWKGIemKLgzNEPcCnmBoUGgr0gWQBwWd8HAseR-5ie3JYuIM</photo_reference>
   <width>519</width>
   <height>270</height>
  </photo>
 </result>
 <result>
  <name>Private Charter Sydney Habour Cruise</name>
  <vicinity>Australia</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8668910</lat>
    <lng>151.2008140</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJqwS6fjiuEmsRJAMiOY9MSms</place_id>
  <scope>GOOGLE</scope>
  <reference>CpQBhQAAAKGKrbbnAW3_eAypKW9bhAzAuSmaqAogs7MTFxsntDqCzt-gKD9nz-zqNsk0uJsl0yCUYpNYjHz_yzmh3J_4TTxpxIqdaq2uDvfoTYtvm8FkxMAkK3cS7k9t3Ze2aHRWnxlN9hczK2xlc5taDE7xAGOHF5Xe5IlVV1wV66sOrWrlHtGh47lqT9Id86eG2OmlVhIQo4djLtRkceg-zaYjULYEjRoUToVEyOUVCFfZMUs_E7ZLSzjFmcg</reference>
  <id>45a27fd8d56c56dc62afc9b49e1d850440d5c403</id>
  <photo>
   <photo_reference>CnRnAAAAUW97jpK2_C2Lh4jLPVKZlhyS84mqZxvVmWFdc6jdl3XxjzKbYdbJpz0PGW5eFRw6kTKYNZM9QvRf-csFegHILZxLCLJ-6ZnbdEXbVM4kBzOb-rhchJx1KC6LHs_vVWP8bK96569lFYRf7Hn8ylQrlhIQb69_dcZVwqQhREsHW6azWhoU0XMWqZMBBzx-hgpduAaeErOFg8E</photo_reference>
   <width>640</width>
   <height>426</height>
  </photo>
 </result>
 <result>
  <name>Bucks Party Cruise</name>
  <vicinity>37 Bank St, Pyrmont</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8709430</lat>
    <lng>151.1903110</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
  <place_id>ChIJLfySpTOuEmsRsc_JfJtljdc</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBdAAAAOMUoYamsekTDxBDVyKZ-E54VQ6HjirVzAZBBwz5gcn5KTfmemmwmOAtLcvRScp1NLQmj-fBYzEO2Gq_cO4Dc12PG0_twzDv9zq3KIyNQVuO-r0n1eQVj8Dlng-n4c1F2hMxufCNVp4-QfjMj81qXJm0invQMUc1xNgZRyiOpLe9EhDLn0KiVWEFKOURYsWrHRouGhR7YMJxYmFs-OXjKyzQKGdQXLrzPw</reference>
  <id>30bee58f819b6c47bd24151802f25ecf11df8943</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAjboYP9Ujxe5SmZFN5AJc42AWtpYFX9wYdqjcTXavXJlfoXdHPC2hErdbHcaeYJBNPV6CzoDc2RLw_w9HofGOhCWHtoAl9b3g8TZZjnZobnAHxoljUdgV8PXyd-pCO-QHKOtiKfIdUmF4HRj2QHj6OhIQhLNpoKNKP8MNjk90M4KGrhoUW2NyBgsWjRpUEoWlt0fD48BhEcQ</photo_reference>
   <width>800</width>
   <height>600</height>
  </photo>
 </result>
 <result>
  <name>Australian Cruise Group</name>
  <vicinity>32 The Promenade, King Street Wharf 5, Sydney</vicinity>
  <type>travel_agency</type>
  <type>restaurant</type>
  <type>food</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675910</lat>
    <lng>151.2011960</lng>
   </location>
  </geometry>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
  <place_id>ChIJrTLr-GyuEmsRBfy61i59si0</place_id>
  <scope>GOOGLE</scope>
  <reference>CoQBeAAAAJZA0WY2pKnZ6nNnxNd_pSDA2NilDLfGDf7pTt7VssxB5tMYE7400w3HZHRav2unpKRhEp7lrh0yKcVdSfKYIz85k1SExoLGmYD8NIf1dPr8KlkRWOYZUTLGp623r5hAzEGk94mPleF4s50pWqLrhAzwvJb1tGj2ak-2PXQORkeTEhAfTj6tMFo_tRWZYOnYCxiVGhQA3n-KV7AW5MvJlGaIDHuLyyEBBA</reference>
  <id>a97f9fb468bcd26b68a23072a55af82d4b325e0d</id>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>CnRnAAAAhTkpwozMoZx_NXMkIrKdcEGe46BmPy3GPCfS-gkCK5PlR8rFDY9DtD_7wFYAIdhVoZz3I9QguRNbil5y37jTU-03GJ_LqVw_avSxFkT0g2kU0K5z2VYnAsgNsrbsK_EVglhg5PrDybC1tAVKCXSGsRIQOcdlAVnC1Qc46YLWjlqdyxoUL5JGZgczfo1jxLxhDeGs8OvBQCk</photo_reference>
   <width>200</width>
   <height>242</height>
  </photo>
 </result>
</PlaceSearchResponse>

Uma resposta XML consiste em um único elemento <PlaceSearchResponse> e até quatro elementos de nível superior:

  • <status> contém os metadados da solicitação. Consulte Códigos de status abaixo.
  • Zero ou mais elementos <result>, cada um contendo informações sobre um único estabelecimento. Consulte Resultados de Nearby Search para obter informações sobre esses resultados. A Places API retorna até 20 resultados de establishment por consulta. Adicionalmente, resultados political <type> ou ruas podem ser retornados, que servem para identificar a área da solicitação.
  • next_page_token contém um token que pode ser usado para retornar até 20 resultados adicionais. Um next_page_token não será retornado se não houver resultados adicionais a exibir. O número máximo de resultados que podem ser retornados é 60. O next_page_token ficará ativo 2 segundos após ser emitido pela primeira vez.
  • html_attributions contém uma série de atribuições sobre essa listagem que devem ser exibidas para o usuário.

Códigos de status

O campo status dentro do objeto de resposta da pesquisa contém o status da solicitação e pode conter informações de depuração para ajudar a rastrear o motivo da falha da solicitação. O campo "status" pode conter os seguintes valores:

  • OK indica que nenhum erro ocorreu; o local foi detectado com sucesso e pelo menos um resultado foi retornado.
  • ZERO_RESULTS indica que a pesquisa foi bem-sucedida, mas não retornou resultados. Isso pode ocorrer se a pesquisa recebeu latlng em um local remoto.
  • OVER_QUERY_LIMIT indica que a cota foi ultrapassada.
  • REQUEST_DENIED indica que a solicitação foi negada, geralmente devido à falta de um parâmetro key inválido.
  • INVALID_REQUEST geralmente indica que um parâmetro obrigatório da consulta (location ou radius) está ausente.

Mensagens de erro

Quando o serviço Google Places retorna um código de status diferente de OK, pode haver um campo error_message adicional dentro do objeto da resposta da pesquisa. Esse campo contém informações mais detalhadas sobre os motivos por trás do código de status.

Resultados da pesquisa

Quando o serviço Google Places retorna resultados JSON de uma pesquisa, ele os coloca em uma matriz results. Mesmo se o serviço não retornar nenhum resultado (como quando location é remoto), ele ainda retornará uma matriz results vazia. Respostas XML consistem em zero ou mais elementos <result>.

Cada elemento da matriz results contém um único resultado da área especificada (location e radius), ordenado por proeminência.

O resultado também pode conter informações de atribuição que devem ser exibidas ao usuário. Este é um exemplo de uma atribuição em formato JSON:

"html_attributions" : [
      "Listings by \u003ca href=\"http://www.example.com/\"\u003eExample Company\u003c/a\u003e"
],
Esta é uma atribuição em formato XML:
<html_attribution>Listings by <a href="http://www.example.com/">Example Company</a></html_attribution>

Cada resultado dentro da matriz results pode conter os seguintes campos:

  • icon contém o URL de um ícone recomendado que pode ser exibido ao usuário quando indicar esse resultado.
  • id contém um identificador estável exclusivo indicando esse local. Esse identificador não pode ser usado para recuperar informações sobre esse local, mas é garantidamente válido entre sessões. Ele pode ser usado para consolidar dados sobre esse local e verificar a identidade de um local em pesquisas separadas. Observação: o id agora está obsoleto e foi substituído por place_id. Consulte o aviso de obsolescência nesta página.
  • geometry contém informações de geometria sobre o resultado, normalmente incluindo a location (código geográfico) do local e (opcionalmente) a viewport, que identifica a área geral de cobertura.
  • name contém o nome legível por humanos para o resultado retornado. Para resultados de establishment, esse é normalmente o nome da empresa.
  • opening_hours pode conter as seguintes informações:
    • open_now é um valor booleano indicando se o local está aberto no momento atual.
  • photos[] é uma matriz de objetos photo, cada um contendo referência a uma imagem. Uma Place Search retornará no máximo um objeto photo. Realizar uma solicitação de Place Details no local pode retornar até dez fotos. Mais informações sobre fotografias de locais e como se pode usar as imagens no aplicativo estão na documentação de Place Photos. Um objeto photo é descrito como:
    • photo_reference — uma string usada para identificar a fotografia ao fazer uma solicitação de Photo.
    • height — a altura máxima da imagem.
    • width — a largura máxima da imagem.
    • html_attributions[] — contém as atribuições necessárias. Esse campo sempre estará presente, mas poderá estar vazio.
  • place_id — um identificador textual que identifica um local de forma exclusiva. Para recuperar informações sobre o local, passe esse identificador no campo placeId de uma solicitação da Places API. Para saber mais sobre IDs de local, consulte a visão geral de IDs de local.
  • scope indica o escopo do place_id. Os valores possíveis são:
    • APP: o ID de local é reconhecido apenas pelo seu aplicativo. Isso ocorre porque o aplicativo adicionou o local e ele ainda não passou pelo processo de moderação.
    • GOOGLE: O ID de local está disponível para outros aplicativos e no Google Maps.
    Observação: o campo scope é incluído apenas em resultados de Nearby Search e de Place Details. Você só pode recuperar locais no escopo do aplicativo usando solicitações de Nearby Search e Place Details. Se o campo scope não está presente em uma resposta, é seguro supor que o escopo seja GOOGLE.
  • alt_ids — uma matriz de zeros, um ou mais IDs de local alternativos para o local, com um escopo referente a cada ID alternativo. Observação: essa matriz pode estar vazia ou não estar presente. Se estiver presente, ela conterá os seguintes campos:
    • place_id — o motivo mais provável para que um local tenha um ID alternativo de local é se seu aplicativo adicionar um local, receber um ID de local no escopo do aplicativo e, posteriormente, receber um ID de local no escopo do Google, depois de passar pelo processo de moderação.
    • scope — o escopo de um ID alternativo de local sempre será APP, indicando que o ID alternativo de local é reconhecido apenas pelo seu aplicativo.
    Por exemplo, vamos supor que o seu aplicativo adicione um local e receba um place_id de AAA para o novo local. Mais tarde, o local passa pelo processo de moderação e recebe um place_id de BBB no escopo do Google. A partir desse ponto, as informações para esse local conterão:
        "results" : [
          {
            "place_id" : "BBB",
            "scope" : "GOOGLE",
            "alt_ids" : [
              {
                "place_id" : "AAA",
                "scope" : "APP",
              }
            ],
          }
        ]
        
  • price_level — o nível de preço do local, em uma escala de 0 a 4. O valor exato indicado por um nível específico varia entre regiões. Os níveis de preço são interpretados da seguinte forma:
    • 0 — Gratuito
    • 1 — Barato
    • 2 — Moderado
    • 3 — Caro
    • 4 — Muito caro
  • rating contém a classificação do local, de 1.0 a 5.0, com base em avaliações agregadas de usuários.
  • reference contém um token exclusivo que pode ser usado para recuperar informações adicionais sobre esse local em uma solicitação de Place Details. Apesar de esse token identificar o local de forma exclusiva, o inverso não é verdadeiro. Um local pode ter muitos tokens de referência válidos. Não é garantido que o mesmo token seja retornado para qualquer local entre diferentes pesquisas. Observação: o campo reference agora está obsoleto e foi substituído por place_id. Consulte o aviso de obsolescência nesta página.
  • types[] contém uma matriz de tipos de recursos descrevendo o resultado dado. Consulte a lista de tipos permitidos para saber mais. Respostas XML incluem vários elementos <type> se mais de um tipo está atribuído ao resultado.
  • vicinity contém um nome de recurso de uma localização próxima. Frequentemente esse recurso se refere a uma rua ou um bairro dentro dos resultados dados. A propriedade vicinity só é retornada para uma Nearby Search.
  • formatted_address é uma string contendo o endereço legível por humanos do local. Frequentemente esse endereço é equivalente ao "endereço postal". A propriedade formatted_address só é retornada para uma Text Search.
  • permanently_closed é um sinalizador booleano indicando se o local foi fechado permanentemente (valor true). Se o local não estiver permanentemente fechado, o sinalizador estará ausente da resposta.

Dados premium

Além dos campos listados acima, os clientes Google Places API com uma licença do Premium Plan podem receber os campos a seguir. Esses campos aparecerão como filhos de nível superior do campo result.

  • aspects contém um único objeto AspectRating para a classificação principal do estabelecimento. Cada AspectRating é descrito como:
    • type é o nome do aspecto que está sendo avaliado. Os seguintes tipos são permitidos: appeal, atmosphere, decor, facilities, food, overall, quality e service.
    • rating é a classificação agregada para esse aspecto em particular, de 0 a 30. Observe que as classificações agregadas variam de 0 a 30, enquanto que as classificações que aparecem como parte de uma avaliação variam de 0 a 3.
  • zagat_selected indica que o local foi selecionado como uma localização de qualidade Zagat. O rótulo Zagat identifica locais conhecidos pela qualidade consistentemente alta ou que têm personalidade especial ou exclusiva.
Para saber mais, consulte Dados premium.

Acesso a resultados adicionais

Por padrão, cada Nearby Search ou Text Search retorna até 20 resultados de establishment por consulta. No entanto, cada pesquisa pode retornar até 60 resultados divididos em três páginas. Se a pesquisa retornar mais de 20, a resposta da pesquisa incluirá um valor adicional — next_page_token. Passe o valor de next_page_token para o parâmetro pagetoken de uma nova pesquisa para ver o próximo conjunto de resultados. Se next_page_token for nulo ou não for retornado, não haverá resultados adicionais. Há um breve atraso entre o momento em que um next_page_token é emitido e o momento em que ele se tornará válido. Solicitar a próxima página antes que ela esteja disponível retornará uma resposta INVALID_REQUEST. Tentar novamente a solicitação com o mesmo next_page_token retornará a próxima página de resultados.

Por exemplo, na consulta abaixo, pesquisamos restaurantes perto de Darling Harbour, em Sidnei, Austrália, e classificamos os resultados por distância. Você pode ver que a resposta contém uma propriedade next_page_token.

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&rankby=distance&types=food&key=YOUR_API_KEY
{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [
      {
         "geometry" : {
            "location" : {
               "lat" : -33.867217,
               "lng" : 151.195939
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/cafe-71.png",
         "id" : "7eaf747a3f6dc078868cd65efc8d3bc62fff77d7",
         "name" : "Biaggio Cafe - Pyrmont",
         "opening_hours" : {
            "open_now" : true
         },
         "photos" : [
            {
               "height" : 600,
               "html_attributions" : [],
               "photo_reference" : "CnRnAAAAmWmj0BqA0Jorm1_vjAvx1n6c7ZNBxyY-U9x99-oNyOxvMjDlo2npJzyIq7c3EK1YyoNXdMFDcRPzwLJtBzXAwCUFDGo_RtLRGBPJTA2CoerPdC5yvT2SjfDwH4bFf5MrznB0_YWa4Y2Qo7ABtAxgeBIQv46sGBwVNJQDI36Wd3PFYBoUTlVXa0wn-zRITjGp0zLEBh8oIBE",
               "width" : 900
            }
         ],
         "place_id" : "ChIJIfBAsjeuEmsRdgu9Pl1Ps48",
         "scope" : "GOOGLE",
         "price_level" : 1,
         "rating" : 3.4,
         "reference" : "CoQBeAAAAGu0wNJjuZ40DMrRe3mpn7fhlfIK1mf_ce5hgkhfM79u-lqy0G2mnmcueTq2JGWu9wsgS1ctZDHTY_pcqFFJyQNV2P-kdhoRIeYRHeDfbWtIwr3RgFf2zzFBXHgNjSq-PSzX_OU6OT2_3dzdhhpV-bPezomtrarW4DsGl9uh773yEhDJT6R3V8Fyvl_xeE761DTCGhT1jJ3floFI5_c-bHgGLVwH1g-cbQ",
         "types" : [ "cafe", "bar", "restaurant", "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "geometry" : {
            "location" : {
               "lat" : -33.866786,
               "lng" : 151.195633
            }
         },
         "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
         "id" : "3ef986cd56bb3408bc1cf394f3dad9657c1d30f6",
         "name" : "Doltone House",
         "photos" : [
            {
               "height" : 1260,
               "html_attributions" : [ "From a Google User" ],
               "photo_reference" : "CnRwAAAAeM-aLqAm573T44qnNe8bGMkr_BOh1MOVQaA9CCggqtTwuGD1rjsviMyueX_G4-mabgH41Vpr8L27sh-VfZZ8TNCI4FyBiGk0P4fPxjb5Z1LrBZScYzM1glRxR-YjeHd2PWVEqB9cKZB349QqQveJLRIQYKq2PNlOM0toJocR5b_oYRoUYIipdBjMfdUyJN4MZUmhCsTMQwg",
               "width" : 1890
            }
         ],
         "place_id" : "ChIJ5xQ7szeuEmsRs6Kj7YFZE9k",
         "scope" : "GOOGLE",
         "reference" : "CnRvAAAA22k1PAGyDxAgHZk6ErHh_h_mLUK_8XNFLvixPJHXRbCzg-gw1ZxdqUwA_8EseDuEZKolBs82orIQH4m6-afDZV9VcpggokHD9x7HdMi9TnJDmGb9Bdh8f-Od4DK0fASNBL7Me3CsAWkUMWhlNQNYExIQ05W7VbxDTQe2Kh9TiL840hoUZfiO0q2HgDHSUyRdvTQx5Rs2SBU",
         "types" : [ "food", "establishment" ],
         "vicinity" : "48 Pirrama Rd, Pyrmont"
      },
      {
         "aspects" : [
            {
               "rating" : 23,
               "type" : "overall"
            }
         ],
      ...
   ],
   "status" : "OK"
}

Para ver o próximo conjunto de resultados, você pode enviar uma nova consulta passando o resultado de next_page_token para o parâmetro pagetoken Por exemplo:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

Configurar pagetoken fará com que todos os outros parâmetros sejam ignorados. A consulta executará a mesma pesquisa de antes, mas retornará um novo conjunto de resultados. Você pode solicitar uma nova página até duas vezes após a consulta original. Cada página de resultados deve ser exibida separadamente. Duas ou mais páginas de resultados da pesquisa não devem ser exibidas como resultado de uma única consulta. Observe que cada pesquisa conta como uma única solicitação em relação aos seus limites de uso.

O parâmetro sensor

A Google Places API anteriormente exigia a inclusão do parâmetro sensor para indicar se o aplicativo usou um sensor para determinar a localização do usuário. Esse parâmetro não é mais obrigatório.

Enviar comentários sobre…

location_on
Google Places API Web Service