Introdução
O formato de resposta das APIs
Place Details (novo),
Nearby Search (novo)
e
Text Search (novo)
mudou em relação ao formato das APIs legadas. A principal diferença está no formato do objeto Place retornado por cada método, conforme descrito em Mudanças no objeto de resposta Place.
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 nas proximidades
- 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 de Place Details (novo),
Nearby Search (novo) e
Text Search (novo) em comparação com o legado
objeto Place.
O novo objeto de resposta usa camel case para nomes de campo, 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 do microformato de 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 de 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 lugares 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 em texto agora está acessível 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
Mudança nas 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 |
|
| Compensação 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 pessoas em cadeira de rodas | 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 principal de lugar | primaryTypeName |
Novo | |
| Colocar o tipo principal como uma string de texto | primaryTypeDisplayName |
Novo | |
| Horário de funcionamento secundário semanal regular, 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 sobre recarga de veículos elétricos em 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 da Pesquisa de texto (legada) e do objeto de resposta da Pesquisa de texto (novo). Para a nova API, o único campo de nível superior na resposta é a matriz places.
| Campo | Text Search (legado) | Text Search (novo) | Observações |
|---|---|---|---|
| Atribuições de lugar | html_attributions |
Movido para o novo objeto Place de cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place legado. |
Matriz places do novo objeto Place |
|
| Status da solicitação | status |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) | |
| Qualquer mensagem de erro | error_message |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) | |
| Qualquer mensagem informativa | 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 de resposta da Pesquisa por proximidade (legada) e do objeto de resposta da Pesquisa por proximidade (nova). Para a nova API, o único campo de nível superior na resposta é a matriz places.
| Campo | Nearby Search (legado) | Nearby Search (novo) | Observações |
|---|---|---|---|
| Atribuições de lugar | html_attributions |
Movido para o novo objeto Place de cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place legado. |
Matriz places do novo objeto Place |
|
| Status da solicitação | status |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) | |
| Qualquer mensagem de erro | error_message |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) | |
| Qualquer mensagem informativa | 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 de resposta do Place Details (legado) e do objeto de resposta do Place Details (novo). Para a nova API, o único campo de nível superior na resposta é a matriz places.
| Campo | Place Details (legado) | Place Details (novo) | Observações |
|---|---|---|---|
| Atribuições de lugar | html_attributions |
Mova para o novo objeto Place como attributions |
|
| Place Details (novo) | result que contém o objeto Place legado |
O novo objeto Place | |
| Status da solicitação | status |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) | |
| Qualquer mensagem informativa | info_messages |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) |