Os recursos do SDK do Places para Android disponíveis no seu app são: determinada por uma combinação do número da versão do SDK (por exemplo, 3.5.0) que você especificar na configuração do app, as APIs ativadas na chave de API e como você inicializar seu app. Este guia explica as diferenças entre as versões e como selecionar quais versões serão ativadas no seu app.
Números de versão do SDK
O número da versão do SDK especificado no build.gradle no nível do app determina se o app tem acesso aos recursos que foram adicionados a um versão específica. Por exemplo, o Autocomplete (novo) só está disponível no SDK versão 3.5.0 ou superior.
Para mais informações sobre as alterações introduzidas em cada versão do SDK, consulte a página do Lançamento do SDK para Android .
Versões da API Places para o SDK do Places para Android
Além de especificar um número de versão do SDK, também é preciso selecionar a API Places serviço da API que o SDK chama no console do Google Cloud: a API Places ou API Places (nova). Junto com o número da versão do SDK, o serviço de API que você select determina qual versão de recursos específicos estão disponíveis no aplicativo, como Autocomplete ou Autocomplete (novo). Embora só seja possível especificar um SDK você poderá ativar a API Places e a API Places (nova) no seu chave de API ao mesmo tempo e selecionar o serviço que será chamado pelo SDK o método que você usa para inicializar o SDK no seu aplicativo. No entanto, na maioria dos casos, Ative a API Places (nova) e use as versões (nova) da recursos do SDK no seu app.
Selecione a versão do SDK e os serviços da API
Para selecionar os recursos do SDK disponíveis no app, faça o seguinte:
- No projeto do Google Cloud, ative a API Places, a API Places (nova) ou os dois. Para mais informações, consulte Ativar APIs
- Nas restrições da chave de API, ative a API Places, a API Places (nova) ou os dois. Para mais informações, consulte Como restringir a API chaves.
No arquivo build.gradle no nível do app, especifique um número de versão. Para mais informações, consulte Instalação.
Inicialize seu app chamando o método
Places.initializeWithNewPlacesApiEnabled()ouPlaces.initialize().
Para mais informações sobre como selecionar o serviço da API Places, consulte Configurar sua projeto do Google Cloud.
Recursos do SDK disponíveis em cada versão
A tabela a seguir mostra quais versões do SDK e da API são necessárias para cada SDK Atributo:
| Recurso | API Places ativada na chave de API | Método de inicialização | Versão mínima do SDK |
|---|---|---|---|
| Autocomplete (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Details (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Photos (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Text Search (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places | initialize() |
|
| Current Place | API Places | initialize() |
|
| Place Details | API Places | initialize() |
|
| Place Photos (em inglês) | API Places | initialize() |
Considerações para escolher quais versões ativar
Para ajudar a decidir qual versão escolher, considere o seguinte:
- Se você é um novo cliente e está começando a usar o SDK do Places para Android, comece com a API Places (nova) e o novo SDK.
- Se você já for cliente, poderá continuar usando o SDK atual. No entanto, para aproveitar as melhorias de desempenho e o recurso e melhorias do SDK do Places para Android (novo), você deve usar a nova SDK do Vertex AI Pipelines. Não é necessário migrar ao migrar para o novo SDK. Basta seguir as etapas em Selecionar a versão do SDK e a API e serviços.
- No SDK do Places para Android (novo), os tokens de sessão estão disponíveis a partir do na versão 3.5.0. Para mais informações, consulte Sessão tokens.
- Chamadas feitas usando widgets do Place Autocomplete sempre chamam Place preenchimento automático, e não Place Autocomplete (novo); chamadas de widget não são afetadas pela método de inicialização.
- Place Photos (novo) retorna apenas um URI para uma imagem de bitmap, enquanto o Place O app Fotos só retorna um bitmap. imagem.
- Local atual é disponível apenas no SDK do Places para Android, não no SDK do Places para Android (novo).
Melhorias no SDK do Places para Android (novo)
Esta seção aborda os principais recursos adicionados ao SDK do Places para Android (novo).
Implementado na plataforma padrão do Google Cloud
O SDK do Places para Android (novo) é implementado no serviço infraestrutura no Google Cloud. Essa implementação traz uma plataforma mais segura e confiável. Esse design padrão traz um nível de consistência entre os SDKs, o que melhora a eficiência do desenvolvimento com o SDK do Places para Android (novo).
Desempenho aprimorado
O SDK do Places para Android (novo) tem melhor desempenho, valer a pena substituir os aplicativos que usam o SDK existente.
Novos recursos
O SDK do Places para Android (novo) inclui as versões mais recentes de todos os SDKs recursos:
- Autocomplete (novo)
- Place Details (novo)
- Nearby Search (novo)
- Place Photos (novo)
- Text Search (novo)
Novo serviço Text Search
Text Search (novo): retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo" ou "lojas de calçados perto do Rio de Janeiro" ou "123 Main Street". O serviço responde com uma lista de locais correspondentes à string de texto e a qualquer polarização de localização definida.
Novos dados de resposta adicionados ao Placed Details (novo) e Place Photos (novo)
Place Details (Novo) agora inclui o novo Revisão no objeto
Placeda resposta. O Classe Place contém o novo métodogetReviews()para oferecer suporte a esse campo. LigaçãogetReviews()para retornar até cinco avaliações de um lugar.Place Photo (Novo) adiciona o
AuthorAttributionspara a classePhotoMetadata.AuthorAttributionscontém umListdeAuthorAttributionobjetos.
Nova resposta de URI adicionada ao Place Photos (novo)
Agora é possível usar Place Photo (New) para retornar um URI para um bitmap de imagem. Antes, só era possível retornar o próprio bitmap de imagem.
Preços simplificados
Os preços foram simplificados com o SDK do Places para Android (novo), para que você pelos dados que usar. O preço simplificado é implementado usando listas de campos, também chamadas de máscaras de campo.
Com Place Details e Text Search você usa listas de campos para controlar a lista de para retornar na resposta. Você será cobrado apenas pelos dados solicitado. Usar uma lista de campos é uma boa prática de design para garantir que você não solicitar dados desnecessários, o que ajuda a evitar tempo de processamento desnecessário e cobranças de faturamento adicionais.
Para obter informações detalhadas sobre preços de ambos os SDKs, consulte Uso e Faturamento.
Tipos de lugar expandidos
O novo SDK adiciona os tipos de lugar mostrados na tabela a seguir. Esses tipos são retornados como parte dos Place Details e Resposta do Text Search. Você também pode usar esses novos tipos, e os tipos existentes em uma pesquisa com Text Search. Os novos tipos estão incluídos na Tabela R:
| 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 | para playgrounds. | 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 da API Places (nova). Isso significa que agora você pode usar esses tipos como parte de uma pesquisar:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality