Migrar a resposta da API Places

O formato de resposta das novas APIs Place Details, Nearby Search e Text Search mudou em relação ao formato das APIs atuais. A principal diferença está no formato do objeto Place retornado por cada método, conforme descrito em Mudanças no objeto Place da resposta.

Além disso, os campos de nível superior do objeto de resposta também mudaram para cada API. Veja estes tópicos:

Mudanças no objeto Place da resposta

Esta tabela mostra as mudanças no novo objeto Place na resposta para Place Details (novo), Nearby Search (novo) e Text Search (novo), em comparação com o objeto Place atual.

O novo objeto de resposta usa letras maiúsculas para nomes de campos, contém novos campos e renomeia alguns dos campos existentes.

Campo Objeto Place atual Objeto New Place Observações
Componente de endereço address_components addressComponents
Endereço de microformato do lugar adr_address adrFormatAddress
Status da empresa business_status businessStatus
Horário de funcionamento da próxima semana current_opening_hours currentOpeningHours
Resumo editorial editorial_summary editorialSummary
Endereço formatado formatted_address formattedAddress
Número de telefone nacional formatted_phone_number nationalPhoneNumber
Local geometry.location location
Janela de visualização geometry.viewport viewport
Atribuições do lugar html_attributions attributions Campo de nível superior da resposta nas APIs atuais
URL de ícone icon Removido. Use iconMaskBaseUri e iconBackgroundColor. Consulte Ícones de lugar para mais informações.
Cor de segundo plano do ícone icon_background_color iconBackgroundColor
URL da máscara do ícone icon_mask_base_uri iconMaskBaseUri
Número de telefone internacional international_phone_number internationalPhoneNumber
Nome do lugar do texto name displayName O nome do lugar de texto agora pode ser acessado como displayName.text e language como displayName.languageCode
Horários de funcionamento opening_hours regularOpeningHours
Fotos photos photos O formato de photos mudou no novo objeto Place. Para mais informações, consulte Mudar para referências de fotos.
ID do lugar place_id id
Plus Code plus_code plusCode
Nível de preço price_level priceLevel
Classificação rating rating
Avaliações reviews reviews
Horário de funcionamento secundário para a próxima semana a partir de hoje, com exceções e todos os outros dados secondary_opening_hours currentSecondaryOpeningHours
Tipos de lugar types types
URL do Google Maps do lugar url googleMapsUri
Número de avaliações de usuários user_ratings_total userRatingCount
Deslocamento de UTC utc_offset utcOffsetMinutes
Forma abreviada do endereço, incluindo o nome da rua e a cidade vicinity shortFormattedAddress
Site do local website websiteUri
Informações sobre acessibilidade para cadeirantes wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance agora está em accessibilityOptions.wheelchairAccessibleEntrance
Atributos de lugares takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
Nome do recurso Campo name no formato places/PLACE_ID Na API atual, o campo name continha o nome do lugar como uma string de texto. Na nova API, essas informações estão em displayName.
Colocar o tipo principal primaryTypeName Novo
Colocar o tipo principal como uma string de texto primaryTypeDisplayName Novo
Horário de funcionamento secundário semanal normal, com exceções e todos os outros dados regularSecondaryOpeningHours Novo
Opções de pagamento aceitas pelo local paymentOptions Novo
Opções de estacionamento parkingOptions Novo
Lista de subdestinos relacionados ao lugar subDestinations Novo
Informações mais recentes sobre as opções de combustível em um posto de gasolina fuelOptions Novo
Informações sobre o carregamento de VEs de um lugar evChargeOptions Novo
Atributos de lugares outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports Novo

Mudanças na resposta da Pesquisa de texto

A tabela a seguir mostra as mudanças nos campos de nível superior do objeto de resposta para a Pesquisa de texto atual e o objeto de resposta para a Pesquisa de texto (novo). Para a nova API, o único campo de nível superior na resposta é a matriz places.

Campo Pesquisa de texto (existente) Text Search (novo) Observações
Atribuições do lugar html_attributions Mudou para o novo objeto Place para cada lugar como place.attributions
Matriz de lugares Matriz results do objeto Place Matriz places do novo objeto Place
Status da solicitação status Mudou para a resposta HTTP padrão (código e mensagem de resposta HTTP)
Qualquer mensagem de erro error_message Mudou para a resposta HTTP padrão (código e mensagem de resposta HTTP)
Qualquer mensagem de informação info_messages Removido
Token da página next_page_token Removido

Mudanças na resposta do Nearby Search

A tabela a seguir mostra as mudanças nos campos de nível superior do objeto resposta para a Pesquisa Nearby existente e o objeto resposta para a Pesquisa Nearby (nova). Para a nova API, o único campo de nível superior na resposta é a matriz places.

Campo Nearby Search (existente) Nearby Search (novo) Observações
Atribuições do lugar html_attributions Mudou para o novo objeto Place de cada lugar como place.attributions
Matriz de lugares Matriz results do objeto Place Matriz places do novo objeto Place
Status da solicitação status Mudou para a resposta HTTP padrão (código e mensagem de resposta HTTP)
Qualquer mensagem de erro error_message Mudou para a resposta HTTP padrão (código e mensagem de resposta HTTP)
Qualquer mensagem de informação info_messages Removido
Token da página next_page_token Removido

Mudanças na resposta do Place Details

A tabela a seguir mostra as mudanças nos campos de nível superior do objeto resposta para os Detalhes do lugar existentes e o objeto resposta para Detalhes do lugar (novo). Para a nova API, o único campo de nível superior na resposta é a matriz places.

Campo Place Details (Existing) Place Details (New) Observações
Atribuições do lugar html_attributions Mudou para o novo objeto Place como attributions
Detalhes do lugar result contendo o objeto Place O novo objeto Place
Status da solicitação status Mudou para a resposta HTTP padrão (código e mensagem de resposta HTTP)
Qualquer mensagem de informação info_messages Mudou para a resposta HTTP padrão (código e mensagem de resposta HTTP)