A API Places é compatível com duas versões: API Places são as APIs atuais e API Places (nova) são 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ê é um novo cliente ou um cliente 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ê for um cliente atual, use esta tabela para determinar a nova API que substitui a que você está usando no momento.
API Places | API Places (nova) | Observação |
---|---|---|
Find Place | Text Search (novo) | Não há nova versão do Find Place. O recurso Text Search (novo) foi substituído. |
Nearby Search (link em inglês) | Nearby Search (novo) | Todas as solicitações que usam a API existente que incluem uma consulta de texto precisam usar Text Search (New) porque o Nearby Search (novo) não é compatível com a entrada de texto. |
Text Search (em inglês) | Text Search (novo) | |
Place Details | Place Details (novo) | |
Place Photo (em inglês) | Place Photo (novo) | |
Place Autocomplete | Preenchimento automático (novo) | Em pré-lançamento |
Preenchimento automático de consultas | Preenchimento automático (novo) | Recursos adicionados à versão de pré-lançamento do 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 existentes. Se apenas a API Places estiver ativada no projeto associado à chave de API usada no seu app, ele não vai 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 para o SDK do Places para iOS (novo) e o 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 atual e quiser migrar para a nova, consulte os guias de migração de cada API a seguir:
- 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 (nova)
Esta seção aborda os principais recursos adicionados à API Places (nova).
Implementado na plataforma padrão do Google Cloud
A API Places (nova) é implementada na infraestrutura de serviços no Google Cloud. Essa implementação oferece uma plataforma mais segura e confiável com opções de segurança aprimoradas, como o OAuth. Esse design de API padrão traz um nível de consistência entre as APIs que melhoram a eficiência de desenvolvimento com a API Places (nova).
Tem desempenho aprimorado
A API Places (nova) fornece uma performance aprimorada, fazendo com que valha a pena substituir os apps que usam essa API.
Preços simplificados
Os preços foram simplificados com a API Places (nova) para que você pague apenas pelos dados que usar. Os preços simplificados são implementados usando uma máscara de campo.
Com Place Details (New), Nearby Search (New) e Text Search (New), você usa a máscara de campo para controlar a lista de campos que vão ser retornados na resposta. Você só será cobrado pelos dados solicitados. O uso da máscara 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 de faturamento e tempo de processamento desnecessários.
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 lugar. A API Places (nova) padroniza a resposta para que todas elas retornem os mesmos dados de um lugar.
Tipos de lugar expandidos
A resposta da API agora pode conter o tipo principal de um local. Cada lugar pode ter um único valor que é especificado como o tipo principal, conforme listado na Tabela A.
Além disso, a nova API adiciona os tipos de locais mostrados na tabela abaixo. Você pode usar esses novos tipos e os já existentes em uma pesquisa com o Nearby Search (novo) e o Text Search (novo). 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 | heliporto | 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 |
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality
Dados dinâmicos do 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. Use esses campos de resposta para criar experiências dinâmicas do usuário.
Qual API você deve escolher?
Antes de iniciar o desenvolvimento de aplicativos, é preciso escolher a API:
Se você é um novo cliente e está começando a usar a API Places, comece pelas novas APIs.
Se você é um novo cliente e ainda não há uma substituição para uma API atual, como Place Autocomplete ou Query Autocomplete, use uma combinação de APIs novas e atuais.
Se você é um cliente atual, pode continuar usando as APIs existentes. No entanto, se quiser aproveitar as melhorias de performance e os recursos da API Places (nova), você pode migrar para as novas.
Para mais informações sobre migração, consulte Visão geral da migração.