Escolher a versão da API

A API Places é compatível com duas versões da API: API Places são as APIs existentes e API Places (Novos) são os próximos de geração de versões mais recentes das APIs.

Com o lançamento da API Places (nova), sua primeira tarefa é decidir qual conjunto de APIs a ser usado. Isso é válido se você é um cliente novo ou atual cliente que já usa as APIs. Use este guia para entender os principais as 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 atual que usam atualmente.

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 usarem a API existente e que incluírem uma consulta de texto deverão usar 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 que você ativou na chave de API controla as APIs usadas pelo app:

  • API Places: ativa as APIs atuais. Apenas se A API Places está ativada para o projeto associado a chave de API usada para seu aplicativo, 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 têm acesso às APIs existentes.

  • Ambos: ativa todos os recursos e APIs para ambos. SDK do Places para iOS (novo) e 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 guias de migração a seguir para cada API:

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) é implementada na infraestrutura de serviços no Google Cloud. Com essa implementação, é possível criar com opções de segurança reforçada como OAuth. Esta API padrão o design traz um nível de consistência entre as APIs que melhora a eficiência de desenvolvimento com a API Places (nova).

Desempenho aprimorado

A API Places (nova) oferece melhor desempenho, o que vale a pena substituir os apps que usam a API Places atual.

Preços simplificados

O preço foi simplificado com a API Places (nova) para que você pelos dados que usar. A precificação simplificado é implementada usando uma máscara de campo.

Com o Place Details (novo), Nearby Search (novo) e Text Search (novo), use a máscara de campo para controlar o lista de campos a serem retornados na resposta. Você será cobrado apenas pelos dados solicitado. Usar o mascaramento de campo é uma boa prática de design para garantir que você não solicitam dados desnecessários, o que ajuda a evitar tempo de processamento desnecessário e cobranças de faturamento.

Dados de resposta consistentes para um lugar

Com as APIs atuais, as APIs Place Details, Nearby Search e Text Search As APIs retornaram dados de resposta diferentes para um local. API Places (nova) padroniza a resposta para que todas as APIs retornem os mesmos dados para um local.

Tipos de lugar expandidos

A resposta da API agora pode conter o tipo principal de um local. Todo lugar pode ter um único valor de tipo especificado como o tipo principal do lugar, conforme listado em 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 Nearby Search (novo) e Text Search (novo). Os novos tipos estão todos incluídos 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 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:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

Dados dinâmicos de lugar

A API Places (nova) é compatível com dados de resposta dinâmica, como disponibilidade de um eletroposto ou os preços mais recentes de um posto de gasolina. Usar 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:

  1. Se você é um novo cliente que está começando a usar a API Places, e começar com as novas APIs.

  2. Se você for um novo cliente e ainda não houver um substituto API existente, como Place Autocomplete ou Query Autocomplete, será possível usar uma combinação de APIs novas e atuais.

  3. Se você é um cliente, pode continuar usando a APIs de terceiros. No entanto, para aproveitar as melhorias de desempenho e as melhorias de recursos da API Places (novo), você pode migrar para a novas APIs.

    Para mais informações sobre a migração, consulte Migração geral.