Za pomocą interfejsów Business Profile API możesz utworzyć platformę, na której sprzedawcy będą mogli zarządzać ich działalnością w Google. Na swojej platformie możesz zezwolić partnerom na wyszukiwanie wizytówek z nazwą, adresem i numerem telefonu firmy. Mogą określić własność lokalizacji, a także precyzyjnie określić fizyczną lokalizację firmy według szerokości i długości geograficznej.
Zanim zaczniesz
Zanim zaczniesz korzystać z interfejsów Business Profile API, musisz zarejestrować swoją aplikację i uzyskać dane logowania OAuth 2.0. Szczegółowe informacje o tym, jak zacząć korzystać z interfejsów Business Profile API, znajdziesz w artykule Podstawowa konfiguracja.
Korzystanie z danych adresowych
Aby pracować z danymi adresowymi i geolokalizacyjnymi na swojej platformie, możesz używać 2 różnych zestawów interfejsów API i zasobów: interfejsów API Profilu Firmy i Map API.
Często używane materiały na temat Profilu Firmy
Interfejs API GoogleLocations
pozwala sprzedawcy z wyprzedzeniem sprawdzić, czy prawa do lokalizacji zostały już zgłoszone w Profilu Firmy. W przeciwnym razie sprzedawca może od razu poprosić o dostęp do niego.
Obiekt PostalAddress
reprezentuje fizyczny adres firmy.
Często używane zasoby Map Google
Widżety miejsc JavaScript Map Google są powszechnie używane w ramach przepływów pracy partnerów do tworzenia interaktywnej mapy. Dodatkowo przydatne mogą się okazać następujące interfejsy API Map Google:
- Przewiduj miejsca, z których korzystasz, korzystając z autouzupełniania miejsc i szczegółów miejsca. Szczegółowe informacje o cenach znajdziesz w artykule SKU: autouzupełnianie (dołączone ze szczegółami miejsc) – na sesję.
- Uzyskiwanie informacji o miejscach za pomocą wyszukiwarki miejsc. Informacje o cenach znajdziesz w artykule SKU: Znajdź miejsce.
- Udostępniaj geokodowanie i odwrotne geokodowanie adresów za pomocą funkcji Geokodowanie. Informacje o cenach znajdziesz w artykule SKU: Geocoding.
1 lub 0 dopasowań
Gdy partner szuka pasujących wizytówek dla danej lokalizacji, chce zawęzić wyniki wyszukiwania do 1 lub 0 dopasowań. Oznacza to, że lokalizacja spełnia kryteria wyszukiwania lub jeszcze nie występuje w profilu firmy.
Jeśli jest 1 dopasowanie lub 0 dopasowań, użyj metody accounts.locations.create
, aby utworzyć nową stronę aplikacji, lub postępuj zgodnie z instrukcjami w przewodniku GoogleLocations
, aby zgłosić prawa własności do istniejących informacji o aplikacji. Jeśli Google nie może przetworzyć danych geograficznych adresu, nie udaje się utworzyć lokalizacji, a odpowiedź interfejsu API zawiera żądanie danych LatLng
. Więcej informacji o tym, jak sprzedawca może przekazywać dane LatLng
, znajdziesz w artykule Ręczne dostosowywanie danych geolokalizacji.
Po określeniu współrzędnych LatLng
zostanie utworzona nowa strona aplikacji.
Dopasowania częściowe i wielokrotne
Gdy właściciel firmy lub zespół operacyjny partnera wyszukuje wizytówki pasujące do lokalizacji, wpisywane informacje mogą dać tylko część dopasowania lub uzyskać wiele dopasowań do wyszukiwanego hasła. Aby zawęzić wyniki wyszukiwania do 1 dopasowania lub 0 dopasowań, dopasowania częściowe i wielokrotne są rozstrzygane ręcznie na podstawie 2 przypadków użycia interfejsu API Map Google.
Użytkownik zawęża wyszukiwanie
Jeśli użytkownik platformy partnerskiej szuka lokalizacji i znajduje się na niej wiele częściowych dopasowań, może rozwiązać problem na jeden z tych sposobów:
- Przeanalizuj adresy URL w części dopasowanej i wybierz właściwy adres.
- Zmień lub wpisz ponownie części adresu, aby były dokładniejsze, i zawęź wyniki do 1 lub 0 dopasowań.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=3&hl=pl)
Użytkownik wybiera co najmniej jedno pełne dopasowanie
W niektórych przypadkach wiele lokalizacji może dokładnie odpowiadać adresowi wyszukiwania użytkownika. Na przykład użytkownik może wpisać na platformie partnera ten adres:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Załóżmy, że zwracane są następujące odpowiedzi, z których wszystkie są zgodne z podanym adresem:
- Niezweryfikowana lokalizacja Kasperson Printer Center.
- Bengo Seguro, zweryfikowana lokalizacja.
- niezweryfikowana lokalizacja Garush Productions.
Użytkownik musi ręcznie wybrać odpowiednią firmę. Aby klienci otrzymywali dokładne wskazówki dojazdu do firmy, konieczne może być skorygowanie danych o szerokości i długości geograficznej (LatLng
) tych lokalizacji, co pozwoli zwiększyć ich dokładność. Informacje o tym, jak użytkownicy mogą ręcznie wpisywać dane LatLng
, znajdziesz w artykule Ręczne dostosowywanie danych geolokalizacji.
Ręczne dostosowanie danych geolokalizacji
Aby zwiększyć dokładność informacji o firmie w profilu firmy, firmy mogą dodać jej szerokość i długość geograficzną (LatLng
). Nowe firmy mogą nie znać swoich współrzędnych w miejscu LatLng
, dlatego mogą ręcznie przypiąć pinezkę za pomocą widżetu Miejsca JavaScript Map Google, aby określić dokładne współrzędne LatLng
.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=3&hl=pl)
LatLng
), konieczne jest ręczne dostosowanie współrzędnych poszczególnych lokalizacji.Jakość wyników wyszukiwania
Wyniki wyszukiwania różnią się znacznie w zależności od dokładności wyszukiwanego adresu oraz regionu geograficznego. W regionach rozwijających się często wyświetla się mniej miejsc w Mapach Google i jest niespójna z formatem adresu Google. Prowadzi to do obniżenia jakości wyników wyszukiwania oraz zwiększonego zapotrzebowania na ręczne formatowanie adresów i korzystanie z interfejsu API Map Google.