A API Places oferece suporte a duas versões: API Places são as APIs atuais e API Places (nova) são a próxima geração das APIs.
Com o lançamento da API Places (nova), sua primeira tarefa é decidir qual conjunto de APIs usar. Isso é verdadeiro se você for um cliente novo ou já estiver usando as APIs. Use este guia para entender as principais diferenças entre as duas APIs.
Lista de APIs
A tabela a seguir lista os dois conjuntos de APIs. Se você já é cliente, use esta tabela para determinar a nova API que substitui a que você está usando.
| API Places | API Places (nova) | Observação |
|---|---|---|
| Find Place | Pesquisa de texto (nova) | Não existe uma nova versão do Find Place. O Text Search (novo) a substituiu. |
| Pesquisa por proximidade | Pesquisa por proximidade (novo) | Todas as solicitações que usam a API existente e incluem uma consulta de texto precisam usar o Text Search (novo), porque o Nearby Search (novo) não é compatível com a entrada de texto. |
| Pesquisa de texto | Pesquisa de texto (nova) | |
| Detalhes do lugar | Detalhes do lugar (novo) | |
| Place Photo | Place Photo (novo) | |
| Place Autocomplete | Preenchimento automático (novo) | |
| Preenchimento automático de consultas | Autocomplete (novo) | Recursos adicionados ao Autocomplete (novo) |
A versão do serviço da API Places que você ativa na chave de API controla as APIs usadas pelo app:
API Places: ativa as APIs atuais. Se apenas a API Places estiver ativada para o projeto associado à chave de API usada no app, ele não terá acesso às novas APIs.
API Places (nova): ativa todas as APIs e os recursos novos descritos em Principais recursos adicionados ao SDK do Places para iOS (novo). O app não terá acesso às APIs atuais.
Ambos: ativa todos os recursos e APIs do SDK do Places para iOS (novo) e do SDK do Places para iOS.
Para mais informações sobre como selecionar o serviço da API Places, consulte Configurar seu projeto do Google Cloud.
Migrar para as novas APIs
Se você estiver usando uma API e quiser migrar para a nova, consulte os seguintes guias de migração para cada uma delas:
- Migrar para a Pesquisa por proximidades (novo)
- Migrar para o Text Search (novo)
- Migrar para o Place Details (novo)
- Migrar para o Place Photo (novo)
- Migrar para o preenchimento automático (novo)
Principais recursos adicionados à API Places (novo)
Esta seção aborda os principais recursos adicionados à API Places (novos).
Implementado na plataforma padrão do Google Cloud
A API Places (nova) é implementada na infraestrutura de serviço no Google Cloud. Essa implementação traz uma plataforma mais segura e confiável com opções de segurança reforçada como o OAuth. Esse design de API padrão oferece um nível de consistência entre as APIs que melhoram a eficiência do desenvolvimento com a API Places (nova).
Desempenho aprimorado
A API Places (nova) oferece melhor desempenho, o que torna a substituição de apps que usam a API Places atual mais vantajosa.
Precificação simplificada
O preço é simplificado com a API Places (nova), para que você pague apenas pelos dados que usa. O preço simplificado é implementado usando uma máscara de campo.
Com o Place Details (novo), o Nearby Search (novo) e o Text Search (novo), você usa a máscara de campo para controlar a lista de campos a serem retornados na resposta. A cobrança é feita apenas pelos dados solicitados. O uso de mascaramento de campo é uma boa prática de design para garantir que você não solicite dados desnecessários, o que ajuda a evitar cobranças desnecessárias de tempo de processamento e cobrança.
Dados de resposta consistentes para um lugar
Com as APIs atuais, as APIs Place Details, Nearby Search e Text Search retornavam dados de resposta diferentes para um lugar. A API Places (nova) padroniza a resposta para que todas retornem os mesmos dados para um local.
Tipos de lugar expandidos
A resposta da API agora pode conter o tipo principal de um local. Cada lugar pode ter um único valor de tipo especificado como o tipo principal, conforme listado na Tabela A.
Além disso, a nova API adiciona os tipos de lugar mostrados na tabela abaixo. É possível usar esses novos tipos e os existentes em uma pesquisa com a Pesquisa por proximidade (nova) e a Pesquisa de texto (nova). Os novos tipos estão incluídos na tabela A.
| Tipo | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | fazenda | korean_restaurant | sporting_goods_store |
| barber_shop | hotel-fazenda | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | mercado | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | alfaiate |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | motel | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| consultor | Heliport | playground | vegetarian_restaurant |
| convention_center | hiking_area | pré-escolar | vietnamese_restaurant |
| casa de campo | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | albergue | resort_hotel | atacadista |
| dental_clinic | hotel | rest_stop |
Junto com esses novos tipos, a API Places (nova) moveu os tipos a seguir da Tabela 2 para a API Places para a tabela A na API Places (novo). Isso significa que agora você pode usar esses tipos como parte de uma pesquisa:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dados dinâmicos de lugares
A API Places (nova) oferece suporte a dados de resposta dinâmicos, como a disponibilidade de uma estação de recarga de VEs ou os preços de combustível mais recentes de um posto de gasolina. Use esses campos de resposta para criar experiências dinâmicas para os usuários.
Qual API você escolhe?
Antes de começar a desenvolver o app, você precisa escolher a API:
Se você é um novo cliente que está começando a usar a API Places, comece com as novas APIs.
Se você é um novo cliente e ainda não há uma substituição para uma API, como o Place Autocomplete ou o Query Autocomplete, use uma combinação de APIs novas e atuais.
Se você já é cliente, pode continuar usando as APIs atuais. No entanto, para aproveitar as melhorias de desempenho e os recursos aprimorados da API Places (nova), você pode migrar para as novas APIs.
Para mais informações sobre a migração, consulte Visão geral da migração.