Dzięki interfejsom Business Profile API możesz stworzyć platformę, która pozwoli sprzedawcom zarządzać ich firmami w Google. Na swojej platformie możesz zezwolić partnerom na wyszukiwanie informacji o usługach, które pasują do nazwy, adresu i numeru telefonu ich firmy. Mogą one potwierdzić prawo własności do lokalizacji oraz dokładnie określić jej położenie geograficzne za pomocą współrzędnych geograficznych.
Zanim zaczniesz
Zanim użyjesz interfejsów API Profilu Firmy, musisz zarejestrować aplikację i uzyskać poświadczenia OAuth 2.0. Szczegółowe informacje o tym, jak zacząć korzystać z interfejsów Business Profile API, znajdziesz w artykule Konfiguracja podstawowa.
Praca z danymi adresów
Aby pracować z danymi adresowymi i danymi geolokalizacji na swojej platformie, możesz używać 2 różnych zestawów interfejsów API i zasobów: interfejsów API Profilu Firmy i interfejsu API Map.
Często używane zasoby Profilu Firmy
Interfejs API GoogleLocations
pozwala sprzedawcy sprawdzić z wyprzedzeniem, czy dana lokalizacja została już zgłoszona w Profilu Firmy. Jeśli nie, sprzedawca może od razu poprosić o dostęp do tych danych.
Obiekt PostalAddress
reprezentuje adres fizyczny firmy.
Często używane zasoby Map Google
Widżety JavaScript Miejsca w Mapach są często używane w procesach partnerskich do tworzenia map interaktywnych. Przydatne mogą być też te interfejsy API Map:
- Zwracać przewidywane miejsca za pomocą autouzupełniania miejsc i szczegółów miejsca. Szczegółowe informacje o cenach znajdziesz w artykule SKU: autouzupełnianie (usługa zawarta w ramach usługi Szczegóły miejsc) – cena za sesję.
- Wyszukaj informacje o miejscu za pomocą wyszukiwarki miejsc. Szczegółowe informacje o cenach znajdziesz w artykule SKU: znajdowanie miejsc.
- Wykonuj geokodowanie i odwrotne geokodowanie adresów za pomocą funkcji Geokodowanie. Szczegóły dotyczące cen znajdziesz w artykule SKU: kodowanie geoprzestrzenne.
1 lub 0 dopasowań
Gdy partner wyszukuje pasujące informacje o produkcie w przypadku danej lokalizacji, jego celem jest zawężenie wyników wyszukiwania do jednego lub zero pasujących wyników. Oznacza to, że lokalizacja albo spełnia kryteria wyszukiwania, albo nie istnieje jeszcze w profilu firmy.
Jeśli nie ma żadnych pasujących wyników lub jest tylko 1 pasujący wynik, utwórz nową stronę aplikacji za pomocą metody accounts.locations.create
lub postępuj zgodnie z instrukcjami w GoogleLocations
, aby zgłosić roszczenie do istniejącej strony aplikacji. Jeśli Google nie może zgeokodować adresu, utworzenie lokalizacji się nie uda, a odpowiedź interfejsu API zawiera prośbę o dane LatLng
. Informacje o tym, jak sprzedawca może udostępnić dane LatLng
, znajdziesz w artykule Ręczne dostosowywanie danych geolokalizacji.
Po ustaleniu współrzędnych LatLng
nowa strona z informacjami zostanie utworzona.
Częściowe i wielokrotne dopasowania
Gdy właściciel firmy lub zespół operacyjny partnera szuka informacji o ofercie dopasowanych do lokalizacji, wpisywane przez niego informacje mogą prowadzić do częściowego dopasowania lub dopasowania wielokrotnego do zapytania wyszukiwania. Aby zawęzić wyniki wyszukiwania do jednego lub 0 pasujących wyników, częściowe i wielokrotne dopasowania są rozwiązywane ręcznie w ramach 2 zastosować interfejsu API Map Google.
Użytkownik zawęża wyszukiwanie
Gdy użytkownik platformy partnerskiej wyszukuje lokalizację i ma problemy z wielu częściowych dopasowań, może rozwiązać ten problem na jeden z tych sposobów:
- Przeanalizuj adresy częściowo pasujące do Twojego adresu i wybierz ten właściwy.
- Możesz edytować lub ponownie wpisać części adresu, aby zwiększyć dokładność wyszukiwania i ograniczyć wyniki do jednego lub żadnego dopasowania.

Użytkownik wybiera co najmniej 1 pełne dopasowanie
W niektórych przypadkach wiele lokalizacji może w pełni pasować do adresu wyszukiwania użytkownika. Użytkownik może na przykład wpisać na platformie partnera taki adres:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Załóżmy, że zwrócone zostały następujące odpowiedzi, które pasują do podanego adresu:
- Kasperson Printer Center, niepotwierdzona lokalizacja.
- Bengo Seguro, zweryfikowana lokalizacja.
- Garush Productions, niezweryfikowana lokalizacja.
Użytkownik musi ręcznie wybrać pasującą firmę. Aby zapewnić konsumentom dokładne wskazówki dojazdu do firmy, dane o szerokości geograficznej i długości geograficznej (LatLng
) dotyczące tych lokalizacji mogą wymagać dostosowania w celu zwiększenia dokładności. Informacje o tym, jak użytkownicy mogą ręcznie wpisywać swoje LatLng
, znajdziesz w artykule Ręczne dostosowywanie danych geolokalizacji.
Ręczne dostosowywanie danych geolokalizacyjnych
Firmy mogą dodać współrzędne geograficzne (LatLng
) swojej firmy, aby zwiększyć dokładność jej wizytówki w Profilu Firmy. Nowe firmy mogą nie znać swoich współrzędnych LatLng
, dlatego mogą zamiast tego ręcznie umieścić znacznik na widżecie Mapy JavaScript Places, aby określić dokładne współrzędne LatLng
.

LatLng
, konieczne jest ręczne dostosowanie współrzędnych każdej lokalizacji.Jakość wyników wyszukiwania
Wyniki wyszukiwania różnią się w zależności od dokładności adresu, którego szukasz, oraz regionu geograficznego. W regionach rozwijających się często wyświetla się mniej miejsc w Mapach oraz niespójność z formatami adresów Google. W efekcie wyniki wyszukiwania są gorszej jakości, a użytkownicy muszą ręcznie formatować adresy i korzystać z interfejsu Maps API.