A API Places é compatível com duas versões da API: a API Places é as APIs atuais, e a API Places (nova) é a versão de última geração das APIs.
Com o lançamento da API Places (nova), sua primeira tarefa é decidir qual conjunto de APIs usar. Isso é válido se você for um cliente novo ou um atual que já usa 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 substituirá a API que você está usando no momento.
| API Places | API Places (nova) | Observação |
|---|---|---|
| Find Place | Text Search (novo) | Não existe uma nova versão do Find Place. O Text Search (novo) a substituiu. |
| Nearby Search | Nearby Search (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 | Text Search (novo) | |
| Place Details | Place Details (novo) | |
| Place Photo | Place Photo (novo) | |
| Place Autocomplete | Autocomplete (novo) | |
| Preenchimento automático de consultas | Autocomplete (novo) | Recursos adicionados ao Autocomplete (novo) |
A versão do serviço da API Places ativada na chave de API controla as APIs usadas pelo app:
API Places: ativa as APIs atuais. Se apenas a API Places estiver ativada no projeto associado à chave de API usada no seu app, ele não terá acesso às novas APIs.
API Places (nova): ativa todas as novas APIs e recursos descritos em Principais recursos adicionados ao SDK do Places para iOS (novo). Seu app não terá acesso às APIs existentes.
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 existente e quiser migrar para a nova, consulte os seguintes guias de migração para cada API:
- Migrar para o Nearby Search (novo)
- Migrar para o Text Search (novo)
- Migrar para o Place Details (novo)
- Migrar para o Place Photo (novo)
- Migrar para o Autocomplete (novo)
Principais recursos adicionados à API Places (novo)
Esta seção aborda os principais recursos adicionados à API Places (novo).
Implementado na plataforma padrão do Google Cloud
A API Places (nova) foi implementada na infraestrutura de serviços do 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 traz um nível de consistência para as APIs, o que melhora a eficiência do desenvolvimento com a API Places (novo).
Tem desempenho aprimorado
A API Places (nova) melhora o desempenho, então vale a pena substituir os apps que usam a API Places.
Preços simplificados
O preço foi simplificado com a API Places (nova) para que você pague apenas pelos dados que usar. A precificação simplificado é implementada 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. Você será cobrado apenas pelos dados solicitados. Usar o mascaramento de campo é uma prática recomendada 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 existentes, as APIs Place Details, Nearby Search e Text Search retornaram dados de resposta diferentes para um local. 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 dele, conforme listado na Tabela A.
Além disso, a nova API adiciona os tipos de local mostrados na tabela abaixo. Você pode usar esses novos tipos e os tipos existentes em uma pesquisa com o Nearby Search (novo) e o Text Search (novo). Os novos tipos estão todos 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 lugar
A API Places (nova) é compatível com dados de resposta dinâmica, como a disponibilidade de um eletroposto ou os preços mais recentes de um posto de gasolina. Use esses campos de resposta para criar experiências dinâmicas do usuário.
Qual API você deve escolher?
Antes de começar o desenvolvimento de apps, escolha sua API:
Se você é um novo cliente que está começando a usar a API Places, comece com as novas APIs.
Se você for um novo cliente e ainda não houver uma substituição para uma API atual, como Place Autocomplete ou Query Autocomplete, poderá usar uma combinação de APIs novas e atuais.
Se você for um cliente, poderá continuar usando as APIs existentes. No entanto, para aproveitar as melhorias de desempenho e de recursos da API Places (nova), é possível migrar para as novas APIs.
Para mais informações sobre a migração, consulte Visão geral da migração.