Com as APIs do Perfil da Empresa, é possível criar uma plataforma em que seus comerciantes podem gerenciar os negócios deles no Google. Na sua plataforma, você pode permitir que seus parceiros pesquisem fichas com o mesmo nome, endereço e número de telefone da empresa. Eles podem estabelecer a propriedade de um local e posicionar com precisão a localização física da empresa por latitude e longitude.
Antes de começar
Antes de usar as APIs do Perfil da Empresa, você precisa registrar seu aplicativo e receber as credenciais do OAuth 2.0. Para saber como começar a usar as APIs do Perfil da Empresa, consulte Configuração básica.
Como trabalhar com dados de endereço
Para trabalhar com dados de endereço e geolocalização na sua plataforma, você pode usar dois conjuntos diferentes de APIs e recursos: as APIs do Perfil da Empresa e do Maps.
Recursos comuns do Perfil da Empresa
Com a API GoogleLocations
, o comerciante pode ver com antecedência se um local já foi reivindicado no Perfil da Empresa. Caso contrário, o comerciante pode pedir acesso a ele imediatamente.
O objeto PostalAddress
representa o endereço físico de uma empresa.
Recursos comuns do Google Maps
Os widgets do Places para JavaScript do Maps geralmente são usados em fluxos de trabalho de parceiros para criar um mapa interativo. Além disso, as seguintes APIs Maps também são úteis:
- Retorne previsões de locais com o Place Autocomplete e Place Details. Para detalhes sobre preços, consulte SKU: Autocomplete (incluído no Places Details) – por sessão.
- Consulte informações sobre o lugar com o Place Search. Para detalhes sobre preços, consulte SKU: Find Place.
- Forneça a geocodificação e a geocodificação inversa de endereços com a Geocodificação. Para detalhes sobre preços, consulte SKU: geocodificação.
Uma ou nenhuma correspondência
Quando um parceiro pesquisa fichas correspondentes para um local, a meta dele é limitar os resultados a uma ou nenhuma correspondência. Isso significa que o local atende aos critérios de pesquisa ou ainda não existe no Perfil da Empresa, respectivamente.
Quando houver uma ou nenhuma correspondência, use o método accounts.locations.create
para criar uma nova ficha ou siga o guia do GoogleLocations
para reivindicar a propriedade da ficha existente. Se o Google não conseguir geocodificar o endereço, a criação do local vai falhar e a resposta da API vai incluir uma solicitação de dados LatLng
. Para informações sobre como o comerciante pode enviar os dados de LatLng
, consulte Ajuste manual dos dados de geolocalização.
Quando as coordenadas de LatLng
são definidas, a nova página de detalhes é criada.
Correspondências parciais e múltiplas
Quando o proprietário da empresa ou a equipe de operações do parceiro procura fichas de empresa que correspondem a um local, as informações inseridas podem resultar apenas em uma correspondência parcial, ou ele pode receber várias correspondências na consulta de pesquisa. Para restringir os resultados da pesquisa a uma ou zero correspondências, as correspondências parciais e múltiplas são resolvidas manualmente por dois casos de uso da API Maps.
O usuário refina a pesquisa
Quando um usuário da plataforma do parceiro pesquisa um local e encontra várias correspondências parciais, ele pode resolver o problema de uma das seguintes maneiras:
- Analise os endereços de correspondência parcial e selecione o correto.
- Edite ou redigite partes do endereço para aumentar a precisão e restringir os resultados a uma ou nenhuma correspondência.
O usuário escolhe uma ou mais correspondências completas
Em alguns casos, vários locais podem corresponder totalmente ao endereço de pesquisa do usuário. Por exemplo, um usuário pode inserir o seguinte endereço em uma plataforma de parceiro:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Suponha que as seguintes respostas sejam retornadas, todas correspondentes ao endereço fornecido:
- Central de impressoras Kasperson, um local não verificado.
- Bengo Seguro, um local verificado
- Garush Productions, local não verificado
O usuário precisa selecionar manualmente a empresa correspondente. Para garantir que os consumidores recebam rotas precisas até a empresa, os dados de latitude e longitude (LatLng
) desses locais talvez precisem ser ajustados. Para informações sobre como os usuários podem inserir a LatLng
manualmente, consulte Ajuste manual dos dados de geolocalização.
Ajuste manual dos dados de geolocalização
As empresas podem adicionar as coordenadas de latitude e longitude (LatLng
) para aumentar a precisão da ficha no Perfil da Empresa. Empresas novas que não sabem as coordenadas de LatLng
podem fixar um alfinete manualmente com o widget do Places para JavaScript do Maps e conseguir essas coordenadas de LatLng
precisas.
Qualidade dos resultados da pesquisa
Os resultados da pesquisa variam muito de acordo com a precisão do endereço pesquisado e a região geográfica. As regiões em desenvolvimento geralmente mostram menos lugares no Google Maps e estão de acordo com os formatos de endereço do Google. Isso leva a resultados de pesquisa de qualidade inferior e a uma maior necessidade de formatação manual de endereço e uso da API Maps.