O formato de resposta das novas APIs Place Details,
Nearby Search
e
Text Search
mudou do formato das APIs existentes. A principal diferença está no formato do objeto Place retornado por cada método, conforme descrito em Mudanças no objeto Place de 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 nas respostas do Text Search
- Mudanças na resposta do Nearby Search
- Alterações de resposta do Place Details
Alterações no objeto Place de resposta
Esta tabela mostra as mudanças feitas no novo objeto Place na resposta para Place Details (New), Nearby Search (New) e Text Search (New) em comparação com o objeto Place existente.
O novo objeto de resposta usa letras concatenadas para nomes de campos, contém novos campos e renomeia alguns dos campos atuais.
| Campo | Objeto Place | Novo objeto Place | Observações |
|---|---|---|---|
| Componente de endereço | address_components |
addressComponents |
|
| Inserir endereço de microformato | adr_address |
adrFormatAddress |
|
| Status da empresa | business_status |
businessStatus |
|
| Horário de funcionamento na 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 atuais |
| URL de ícone | icon |
Removido. Use iconMaskBaseUri e
iconBackgroundColor. Consulte Ícones de lugar para mais informações. |
|
| Cor de fundo 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 |
|
| Texto do nome do lugar | name |
displayName |
O texto do nome do lugar 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 da 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 lugar no Google Maps | 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 lugar | 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 atual, 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 do lugar | primaryTypeName |
Novo | |
| Colocar o tipo principal como uma string de texto | primaryTypeDisplayName |
Novo | |
| Horário de funcionamento secundário semanal, 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 opções de combustível em um posto de gasolina | fuelOptions |
Novo | |
| Informações de carregamento de VE para um lugar | evChargeOptions |
Novo | |
| Atributos de lugares | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Novo |
Mudanças nas respostas do Text Search
A tabela a seguir mostra as alterações nos campos de nível superior do objeto de resposta do Text Search atual e do objeto de resposta do Text Search (novo). Para a nova API, o único campo de nível superior na resposta é a matriz places.
| Campo | Text Search (Existente) | Text Search (novo) | Observações |
|---|---|---|---|
| Atribuições de lugar | html_attributions |
Movido para o novo objeto Place para cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place atual |
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) | |
| Todas as mensagens informativas | 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
para o Nearby Search atual e o objeto
de resposta
para o Nearby Search (novo). 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 de lugar | html_attributions |
Movido para o novo objeto Place de cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place atual |
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) | |
| Todas as mensagens informativas | info_messages |
Removido | |
| Token da página | next_page_token |
Removido |
Alterações de resposta do Place Details
A tabela a seguir mostra as alterações nos campos de nível superior do objeto de resposta do Place Details 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 (Existente) | Place Details (novo) | Observações |
|---|---|---|---|
| Atribuições de lugar | html_attributions |
Movido para o novo objeto Place como attributions. |
|
| Detalhes do lugar | result contendo o objeto Place existente. |
O novo objeto Place | |
| Status da solicitação | status |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) | |
| Todas as mensagens informativas | info_messages |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) |