Pesquisa de texto (legado)

Desenvolvedores do Espaço Econômico Europeu (EEE)

A Text Search (legado) retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo", "loja de sapatos perto do Rio de Janeiro" ou "Avenida Brasil, 123". O serviço responde com uma lista de locais correspondentes à string de texto e a todos os direcionamentos de localização definidos.

A Text Search (Legacy) não é destinada a consultas ambíguas, incluindo as seguintes:

Tipo de consulta Exemplo
Muitos conceitos ou restrições, como os nomes de vários lugares, vias ou cidades em uma única consulta "Market Street San Francisco San Jose Airport"
Elementos de endereço postal não representados no Google Maps "A/C João da Silva, Rua Principal, 123"
"Caixa Postal 13, São Paulo"
Nomes de empresas, franquias ou categorias combinados com locais onde essas entidades não estão disponíveis "Tesco perto de Dallas, Texas"
Consultas ambíguas com várias interpretações "Entrega do carregador"
Nomes históricos que não estão mais em uso "Middlesex United Kingdom"
Elementos ou intenções não geoespaciais "Quantos barcos estão no porto de Ventura?"
Nomes não oficiais ou personalizados "The Jenga"
"The Helter Skelter"
Coordenadas de latitude e longitude "37.422131,-122.084801"

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

Solicitações do Text Search (legado)

Uma solicitação do Text Search (Legacy) é um URL HTTP no 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

  • consulta

    A string de texto em que pesquisar, por exemplo, "restaurante" ou "Rua Principal, 123". Precisa ser o nome, endereço ou categoria de estabelecimentos. Qualquer outro tipo de entrada pode gerar erros e não garante o retorno de resultados válidos. O serviço do Google Places retorna as correspondências possíveis de acordo com essa string e ordena os resultados com base na relevância.

  • raio

    Define a distância (em metros) para retornar resultados de lugares. Você pode influenciar os resultados de um círculo especificado ao transmitir um parâmetro location e radius. Isso instrui o serviço Places a priorizar os resultados dentro desse círculo. Os resultados fora da área definida ainda podem ser exibidos.

    O raio será fixado automaticamente em um valor máximo, dependendo do tipo de pesquisa e de outros parâmetros.

    • Preenchimento automático: 50.000 metros
    • Nearby Search:
      • com keyword ou name: 50.000 metros
      • sem keyword ou name
        • Até 50.000 metros, ajustado dinamicamente com base na densidade da área, independentemente do parâmetro rankby.
        • Ao usar rankby=distance, o parâmetro de raio não será aceito e resultará em um INVALID_REQUEST.
    • Query Autocomplete: 50.000 metros
    • Text Search: 50.000 metros

Parâmetros opcionais

  • language

    O idioma em que os resultados serão retornados.

    • Consulte a lista de idiomas compatíveis. O Google atualiza os idiomas compatíveis com frequência, então esta lista pode não estar completa.
    • Se language não for fornecido, a API vai tentar usar o idioma preferencial, conforme especificado no cabeçalho Accept-Language.
    • A API faz o possível para fornecer um endereço que seja legível para o usuário e os moradores locais. Para isso, ele retorna endereços no idioma local, transliterados para um script legível pelo usuário, se necessário, de acordo com o idioma preferido. Todos os outros endereços são retornados no idioma preferencial. Os componentes de endereço são todos retornados no mesmo idioma, que é escolhido no primeiro componente.
    • Se um nome não estiver disponível no idioma preferido, a API vai usar a correspondência mais próxima.
    • O idioma preferencial tem uma pequena influência no conjunto de resultados que a API escolhe retornar e na ordem em que eles são retornados. O geocodificador interpreta abreviações de maneira diferente dependendo do idioma, como as abreviações de tipos de rua ou sinônimos que podem ser válidos em um idioma, mas não em outro. Por exemplo, utca e tér são sinônimos de rua em húngaro.

  • local

    O ponto em torno do qual as informações do lugar serão recuperadas. Precisa ser especificado como latitude,longitude.

    O parâmetro location poderá ser substituído se o query contiver um local explícito, como Market in Barcelona. O uso de aspas ao redor da consulta também pode influenciar o peso dado a location e radius.

  • maxprice

    Restringe os resultados apenas aos lugares no intervalo especificado. Valores válidos estão no intervalo de 0 (mais barato) a 4 (mais caro). O valor exato indicado por um valor específico varia de acordo com a região.

  • minprice

    Restringe os resultados apenas aos lugares no intervalo especificado. Valores válidos estão no intervalo de 0 (mais barato) a 4 (mais caro). O valor exato indicado por um valor específico varia de acordo com a região.

  • opennow

    Retorna somente os locais que estão no horário de 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 vão ser retornados se esse parâmetro for incluído na consulta.

  • pagetoken

    Retorna até 20 resultados de uma pesquisa realizada anteriormente. Definir um parâmetro pagetoken vai executar uma pesquisa com os mesmos parâmetros usados anteriormente. Todos os parâmetros, exceto pagetoken, serão ignorados.

  • região

    O código da região, especificado como um valor de dois caracteres de ccTLD ("domínio de nível superior"). A maioria dos códigos ccTLD é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD do Reino Unido é "uk" (.co.uk), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade "Reino Unido da Grã-Bretanha e Irlanda do Norte").

  • tipo

    Restringe os resultados aos lugares correspondentes ao tipo especificado. Só é possível especificar um tipo. Se mais de um tipo for fornecido, todos os outros após a primeira entrada vão ser ignorados.

    • type=hospital|pharmacy|doctor se torna type=hospital.
    • type=hospital,pharmacy,doctor é totalmente ignorado

    Consulte a lista de tipos compatíveis.

    Observação: adicionar keyword e type com o mesmo valor (keyword=cafe&type=cafe ou keyword=parking&type=parking) pode gerar ZERO_RESULTS.

Exemplos de Text Search (legado)

Observação:nesses exemplos, é preciso substituir key pela sua chave de API para que a solicitação funcione no aplicativo.

Exemplo básico

O exemplo a seguir mostra uma pesquisa por restaurantes perto de Sydney.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

Exemplo de endereço incompleto

O exemplo a seguir mostra uma pesquisa de um endereço incompleto, neste caso, um endereço que não inclui cidade, estado ou país.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

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

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Exemplo de viés de local

O exemplo a seguir mostra uma pesquisa pelo mesmo endereço incompleto do exemplo anterior e inclui os parâmetros location e radius para priorizar os resultados de uma região de interesse.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

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

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Respostas do Text Search (legado)

As respostas da pesquisa são retornadas no formato indicado pela flag output no caminho da solicitação de URL.

O exemplo a seguir mostra uma resposta da Text Search (Legacy).

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

Campo Obrigatório Tipo Descrição
required Array<string>

Pode conter um conjunto de atribuições sobre essa ficha que precisam ser exibidas ao usuário (algumas fichas podem não ter atribuição).

required Matriz<Place>

Contém uma matriz de lugares.

As solicitações do Place Search retornam um subconjunto dos campos retornados pelas solicitações do Place Details. Se o campo que você quer não for retornado pelo Place Search, use o Place Search para obter um place_id e use esse ID de lugar para fazer uma solicitação do Place Details.

Consulte Local para mais informações.
required PlacesSearchStatus

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.

Consulte PlacesSearchStatus para mais informações.

opcional string

Quando o serviço retorna um código de status diferente de OK<, pode haver um campo error_message adicional no objeto de resposta. Esse campo contém informações mais detalhadas sobre os motivos do código de status fornecido. Esse campo nem sempre é retornado, e o conteúdo dele está sujeito a alterações.

opcional Array<string>

Quando o serviço retorna mais informações sobre a especificação da solicitação, pode haver um campo info_messages extra no objeto de resposta. Esse campo é retornado apenas para solicitações bem-sucedidas. Ele pode não ser retornado sempre, e o conteúdo está sujeito a alterações.

next_page_token

opcional string

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 outros resultados para exibir. O número máximo de resultados que podem ser retornados é 60. Há um pequeno atraso entre o momento em que um next_page_token é emitido e quando ele se torna válido.

PlacesSearchStatus

Códigos de status retornados pelo serviço.

  • OK: indicando que a solicitação de API funcionou.
  • ZERO_RESULTS, indicando que a pesquisa foi bem-sucedida, mas não retornou resultados. Isso pode ocorrer se a pesquisa recebeu um latlng em um local remoto.
  • INVALID_REQUEST: indicando que a solicitação de API estava corrompida, geralmente devido à falta de um parâmetro de consulta obrigatório (location ou radius).
  • OVER_QUERY_LIMIT indicando qualquer uma das seguintes opções:
    • Você excedeu os limites de QPS.
    • O faturamento não foi ativado na sua conta.
    • O crédito mensal de US $200 ou um limite de uso definido pelo próprio usuário foi excedido.
    • A forma de pagamento fornecida não é mais válida (por exemplo, o cartão de crédito expirou).
    Consulte as perguntas frequentes do Maps para mais informações sobre como resolver esse erro.
  • REQUEST_DENIED indica que o pedido foi recusado, geralmente porque:
    • A solicitação não tem uma chave de API.
    • O parâmetro key é inválido.
  • UNKNOWN_ERROR: indicando um erro desconhecido.

Lugar

As respostas do Place Search retornam o seguinte subconjunto de campos de Place. Nem todos os atributos estão disponíveis para todos os tipos de lugar. Para recuperar campos que o Place Search não retorna, como address_components, formatted_phone_number, reviews ou website, transmita o place_id retornado em uma solicitação do Place Details (Legacy). Para saber mais sobre a disponibilidade de campos e os níveis de preços em endpoints, consulte Campos de dados de lugar (legado).

Campo Tipo Descrição
business_status string Indica o status de funcionamento do lugar, se for uma empresa: OPERATIONAL, CLOSED_TEMPORARILY ou CLOSED_PERMANENTLY. Omitido se não houver dados de status.
formatted_address string O endereço legível por humanos deste lugar. Retornado por Text Search (legado) e Find Place (legado). Não analise o endereço formatado de maneira programática. Em vez disso, solicite address_components no Place Details (Legacy).
geometry Geometry Contém o location geocodificado com as coordenadas lat e lng, além do viewport preferencial com os limites northeast e southwest.
icon string O URL de um ícone sugerido que pode ser exibido ao indicar esse resultado em um mapa.
icon_background_color string O código de cor hexadecimal padrão para a categoria do lugar.
icon_mask_base_uri string O URL de base de um ícone recomendado, sem a extensão de tipo de arquivo SVG ou PNG.
name string O nome legível por humanos do resultado retornado. Para resultados de establishment, esse valor geralmente é o nome canônico da empresa.
opening_hours PlaceOpeningHours Informações sobre o horário de funcionamento. Os endpoints do Place Search retornam apenas o subcampo booleano open_now. Solicite opening_hours no Place Details (legado) para periods e weekday_text.
permanently_closed boolean Descontinuado:use business_status para verificar o status de funcionamento de uma empresa.
photos Array<PlacePhoto> Uma matriz de objetos PlacePhoto, cada um contendo um photo_reference, height, width e html_attributions. Para detalhes de uso, consulte Fotos de lugares (legado).
place_id string um identificador textual que identifica um local de forma exclusiva. Transmita esse ID no parâmetro place_id de uma solicitação do Place Details (Legacy). Consulte a visão geral do ID de lugar.
plus_code PlusCode Uma referência de local codificada derivada de coordenadas de latitude e longitude, contendo um global_code e um compound_code opcional.
price_level integer O nível de preço do lugar em uma escala de 0 a 4, do mais barato ao mais caro. Confira price_level.
rating number A nota do lugar (1.0 a 5.0), com base nas avaliações de usuários agregadas.
reference string Descontinuado:use place_id.
scope string Descontinuado:indica o escopo do place_id, que é sempre GOOGLE. Retornado por Nearby Search (legado).
types Array<string> Uma matriz de tipos de recursos que descreve o resultado fornecido. Consulte Tipos de lugar (legado).
user_ratings_total integer O número total de notas, com ou sem texto de avaliação, para este lugar.
vicinity string Um endereço simplificado para o local, incluindo o nome da rua, o número da rua e a localidade, sem o estado ou província, código postal ou país. Retornado pela Nearby Search (legado).

Acessar outros resultados

Por padrão, cada resposta 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 vai incluir um valor adicional: next_page_token. Transmita o valor de next_page_token para o parâmetro pagetoken de uma nova solicitação para ver o próximo conjunto de resultados.

  • Se o next_page_token for nulo ou não for retornado, não haverá mais resultados.
  • Repetir a solicitação com o mesmo next_page_token vai retornar a próxima página de resultados.
  • Definir pagetoken faz com que todos os outros parâmetros sejam ignorados.
  • Você pode pedir uma nova página até duas vezes após a consulta original.
  • Cada solicitação, incluindo uma que use next_page_token, conta como uma única solicitação em relação aos limites de uso e é cobrada separadamente.
  • Há um atraso de alguns segundos entre o momento em que um next_page_token é emitido e quando ele se torna válido. Solicitar a próxima página antes que ela esteja disponível vai retornar uma resposta INVALID_REQUEST. As solicitações com next_page_token são sempre cobradas.

Por exemplo, na consulta abaixo, pesquisamos restaurantes perto de Darling Harbour, em Sydney, Austrália, e classificamos os resultados por distância. A resposta contém uma propriedade next_page_token.

{
   "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" : [...]
   "status" : "OK"
}

Para ver o próximo conjunto de resultados, envie uma nova consulta, transmitindo o resultado de next_page_token para o parâmetro pagetoken. 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