Com as APIs do Perfil da Empresa, é possível criar uma plataforma em que seus comerciantes podem gerenciar os negócios deles no Google. Nela, você pode permitir que os parceiros pesquisem fichas com o mesmo nome, endereço e número de telefone da empresa, reivindicar a propriedade de um local e posicionar com precisão o local físico do negócio 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, 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 a API 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. Se não, 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 Places da API Maps JavaScript normalmente são usados em fluxos de trabalho de parceiros para criar um mapa interativo. Além disso, as seguintes APIs do Google Maps são úteis:
- Retorne previsões de local com a Place Autocomplete e a Place Details. Para detalhes de preços, consulte SKU: Autocomplete (incluído com a Place Details) – Por sessão.
- Consulte informações sobre lugares com a 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 Geocoding. Para detalhes sobre preços, consulte SKU: Geocoding.
Uma ou zero correspondência
Quando um parceiro pesquisa fichas de empresa correspondentes para um local, a meta dele é restringir os resultados a uma ou zero correspondências. Isso significa que o local atende aos critérios de pesquisa ou ainda não existe no Perfil da Empresa, respectivamente.
Nesses casos, use o método accounts.locations.create
para criar uma ficha de empresa ou siga o guia do GoogleLocations
para reivindicar a propriedade da ficha que já existe. Se o Google não conseguir geocodificar o endereço, o local não será criado e a resposta da API 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.
Depois que as coordenadas de LatLng
forem definidas, a nova ficha de empresa será criada.
Correspondências parciais e múltiplas
Quando o proprietário de uma empresa ou a equipe de operações do parceiro procura fichas que correspondam a um local, as informações inseridas podem gerar consultas de pesquisa com correspondência parcial ou retornar várias correspondências. Para restringir os resultados a uma ou zero correspondência, as correspondências parciais e múltiplas são resolvidas de duas maneiras na 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:
- Analisar os endereços de correspondência parcial e selecionar o correto
- Editar ou digitar novamente as partes do endereço de forma mais precisa e limitar os resultados a uma ou zero correspondência
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=0000&hl=pt-br)
O usuário seleciona 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, ao inserir o seguinte endereço em uma plataforma de parceiro:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Suponhamos que sejam retornadas as seguintes respostas, todas correspondentes ao endereço fornecido:
- Gráfica Kasperson, local não verificado
- Bengo Seguro, 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, talvez os dados de latitude e longitude (LatLng
) desses locais 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 Places da API Maps JavaScript para descobrir as coordenadas de LatLng
.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=0000&hl=pt-br)
LatLng
, é necessário ajustar manualmente as coordenadas de cada local.Qualidade dos resultados da pesquisa
Os resultados da pesquisa variam muito com base na precisão do endereço pesquisado e na região geográfica. As regiões em desenvolvimento geralmente mostram menos lugares do Google Maps e endereços fora de conformidade com os formatos do Google. Isso leva a resultados de pesquisa de qualidade inferior e a uma maior necessidade de uso da API Maps e de formatação manual do endereço.