Introdução
O formato de resposta das APIs Place Details (New), Nearby Search (New) e Text Search (New) mudou em relação às APIs legadas. 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 na resposta da pesquisa de texto
- Mudanças na resposta da Pesquisa por locais
- Mudanças na resposta do Place Details
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 legado
objeto Place.
O novo objeto de resposta usa letras maiúsculas para nomes de campos, contém novos campos e renomeia alguns dos campos legados.
| Campo | Objeto da API Places (legada) | Objeto da API Places (nova) | 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 legadas |
| 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 classificações do usuário | 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 legada, o campo name continha o nome do lugar como uma string de texto. Na nova API, essas informações estão em
displayName. |
|
| Tipo de lugar 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 lugar | 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 de carregamento de VEs para 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 (legado) 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 (legado) | Text Search (novo) | Observações |
|---|---|---|---|
| Atribuições de lugar | html_attributions |
Mudou para o novo objeto Place para cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place legada |
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 por proximidades (legado) e o objeto
resposta
para a Pesquisa por proximidades (novo). Para a nova API, o único campo de nível superior na
resposta é a matriz places.
| Campo | Pesquisa nas proximidades (legada) | 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 legada |
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 (novo)
A tabela a seguir mostra as mudanças nos campos de nível superior do objeto
resposta
para os Detalhes do lugar (legado) e o objeto
resposta
para os Detalhes do lugar (novo). Para a nova API, o único campo de nível superior na
resposta é a matriz places.
| Campo | Place Details (Legacy) | Place Details (New) | Observações |
|---|---|---|---|
| Atribuições do lugar | html_attributions |
Mudou para o novo objeto Place
como attributions |
|
| Place Details (New) | result contendo o objeto Place legada |
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) |