Atenção: a v4.8 da API foi lançada. Consulte o registro de alterações. As postagens relacionadas à COVID-19 ainda estão permitidas temporariamente para redes.

Pesquisar fichas de empresa correspondentes

Com a API Google My Business, você pode criar uma plataforma para que seus comerciantes gerenciem as empresas deles no Google. Nela, seus parceiros podem pesquisar fichas que têm 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 a API Google My Business, você precisa registrar seu aplicativo e receber as credenciais do OAuth 2.0. Para saber como começar a usar a API Google My Business, 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: a API Google My Business e a API Google Maps.

Recursos comuns do Google Meu Negócio

A API GoogleLocations permite que o comerciante veja com antecedência se um local já foi reivindicado no Google Meu Negócio. Se não, o comerciante poderá solicitar acesso a ele imediatamente.

O objeto PostalAddress representa o endereço físico de uma empresa.

Recursos comuns do Google Maps

Os widgets de lugar para JavaScript do Google Maps 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:

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ência. Quando um resultado é encontrado, significa que o local corresponde aos critérios de busca, mas, quando nenhum resultado é retornado, significa que o local ainda não existe no Google Meu Negócio.

Nesses casos, use o método accounts.locations.create para criar uma nova ficha de empresa ou siga o guia do GoogleLocations para reivindicar a propriedade da ficha existente. 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.

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
Um usuário recebe várias correspondências parciais em resposta à pesquisa de endereço.

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 Google Meu Negócio. Empresas novas que não sabem as coordenadas de LatLng podem fixar um alfinete manualmente com o widget de lugar em JavaScript do Google Maps para descobrir essas coordenadas de LatLng.

Um único endereço retorna três locais a 457 metros de distância. Para associar com precisão o endereço da empresa às coordenadas de 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.