O formato da resposta para a nova
Place Details,
Pesquisa de locais por perto,
e
Pesquisa de texto
O formato das APIs existentes foi alterado. A principal diferença está no
o 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 têm alteradas para cada API. Veja estes tópicos:
- Mudanças nas respostas da Pesquisa de texto
- Mudanças na resposta do Nearby Search
- Mudanças nas respostas do Place Details
Mudanças no objeto Place de resposta
Esta tabela mostra as alterações na nova
Objeto Place
na resposta a Place Details (novo),
Nearby Search (novo) e
Text Search (novo) em comparação com o atual
objeto Place.
O novo objeto de resposta usa letras concatenadas para nomes de campo, contém novos campos, e renomeia alguns dos campos existentes.
| Campo | Objeto Place existente | Novo objeto Place | Observações |
|---|---|---|---|
| Componente de endereço | address_components |
addressComponents |
|
| Posicionar endereço do microformato | 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 lugares | html_attributions |
attributions |
Campo de nível superior da resposta nas APIs existentes |
| 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 |
|
| Texto do nome do lugar | 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 foi alterado 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 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 lugar | website |
websiteUri |
|
| Informações de acessibilidade para pessoas em cadeira de rodas | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance está agora em
accessibilityOptions.wheelchairAccessibleEntrance |
| Atributos do Places | 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 formulário places/PLACE_ID |
Na API existente, o campo name continha o
nome do lugar como uma string de texto. Na nova API, essas informações estão
displayName: |
|
| Inserir tipo principal | primaryTypeName |
Novo | |
| Insira o tipo primário 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 as opções de combustível em um posto de gasolina | fuelOptions |
Novo | |
| Informações sobre o carregamento de VEs | evChargeOptions |
Novo | |
| Atributos do Places | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Novo |
Alterações nas respostas do Text Search
A tabela a seguir mostra as alterações nos campos de nível superior do
objeto de resposta
para o Text Search e o
objeto de resposta
para 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 lugares | 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 (mensagem e código de resposta HTTP) | |
| Qualquer mensagem de erro | error_message |
Movido para a resposta HTTP padrão (mensagem e código de resposta HTTP) | |
| Qualquer mensagem informativa | info_messages |
Removido | |
| Token da página | next_page_token |
Removido |
Alterações de resposta do Nearby Search
A tabela a seguir mostra as alterações nos campos de nível superior da resposta
objeto
para a Nearby Search existente e a resposta
objeto
para o Nearby Search (novo). Para a nova API, o único campo de nível superior na
a resposta é a matriz places.
| Campo | Nearby Search (Existente) | Nearby Search (novo) | Observações |
|---|---|---|---|
| Atribuições de lugares | html_attributions |
Movido para o novo Place
objeto para cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place atual |
Matriz places do novo valor
Objeto Place |
|
| Status da solicitação | status |
Movido para a resposta HTTP padrão (mensagem e código de resposta HTTP) | |
| Qualquer mensagem de erro | error_message |
Movido para a resposta HTTP padrão (mensagem e código de resposta HTTP) | |
| Qualquer mensagem informativa | info_messages |
Removido | |
| Token da página | next_page_token |
Removido |
Mudanças nas respostas do Place Details
A tabela a seguir mostra as alterações nos campos de nível superior da resposta
objeto
para os detalhes do lugar existentes e a resposta
objeto
de Place Details (novo). Para a nova API, o único campo de nível superior na
a resposta é a matriz places.
| Campo | Place Details (Existente) | Place Details (novo) | Observações |
|---|---|---|---|
| Atribuições de lugares | html_attributions |
Movido para o novo Place
objeto 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 (mensagem e código de resposta HTTP) | |
| Qualquer mensagem informativa | info_messages |
Movido para a resposta HTTP padrão (mensagem e código de resposta HTTP) |