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 Place objeto 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. Confira:
- Mudanças na resposta do Text Search
- Mudanças na resposta do Nearby Search
- Mudanças na resposta do Place Details
Mudanças no objeto Place de resposta
Esta tabela mostra as mudanças no objeto novo
Place na resposta do Place Details (novo),
Nearby Search (novo) e
Text Search (novo) em comparação com o objeto legado
Place.
O novo objeto de resposta usa a capitalização de camel case para nomes de campos, contém novos campos e renomeia alguns dos campos legados.
| Campo | Objeto da API Places (legado) | Objeto da API Places (novo) | 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 de lugar | html_attributions |
attributions |
Campo de nível superior da resposta nas APIs legadas |
| URL de ícone | icon |
Removida. 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 de 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
Place objeto. Para mais informações, consulte
Mudança nas referências de fotos. |
| ID de 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 classificaçõ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 de 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 principal de lugar | primaryTypeName |
Novo | |
| Tipo principal de lugar 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 do lugar | 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 sobre recarga de veículos elétricos 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
da Text Search (legado) e do
objeto de resposta
da Text Search (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 |
Movido para o novo Place objeto de cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place legado |
Matriz places do novo Place objeto |
|
| 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 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
de resposta do Nearby Search (legado) e do objeto
de resposta do Nearby Search (novo). 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 Place
objeto para cada lugar como place.attributions |
|
| Matriz de lugares | Matriz results do objeto Place legado |
Matriz places do novo
Place objeto |
|
| 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 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
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 |
Movido para o novo Place
objeto como attributions |
|
| Place Details (novo) | result contendo 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 de informação | info_messages |
Movido para a resposta HTTP padrão (código e mensagem de resposta HTTP) |