Dzięki interfejsom Business Profile API możesz utworzyć platformę, na której sprzedawcy będą mogli zarządzać swoimi firmami w Google. Na swojej platformie możesz zezwolić partnerom na wyszukiwanie informacji, które pasują do nazwy, adresu i numeru telefonu ich firmy. Mogą potwierdzić własność lokalizacji, a także dokładnie określić fizyczną lokalizację firmy za pomocą szerokości i długości geograficznej.
Zanim zaczniesz
Zanim zaczniesz korzystać z interfejsów Business Profile API, musisz zarejestrować 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 Konfiguracja podstawowa.
Jak pracować z danymi adresowymi
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 Business Profile API i interfejsu API Map Google.
Często używane zasoby dotyczące Profilu Firmy
Interfejs GoogleLocations API pozwala sprzedawcy sprawdzić z wyprzedzeniem, czy lokalizacja została już zgłoszona w Profilu Firmy. Jeśli nie, sprzedawca może natychmiast poprosić o dostęp do niego.
Obiekt PostalAddress reprezentuje adres pocztowy firmy.
Często używane zasoby Map Google
Widżety miejsc w Maps JavaScript są często używane w procesach partnerów do tworzenia interaktywnych map. Przydatne są też te interfejsy API Map Google:
- Zwracaj podpowiedzi miejsc za pomocą autouzupełniania miejsc i informacji o miejscu. Szczegółowe informacje o cenach znajdziesz w artykule SKU: Autouzupełnianie (zawarte w informacjach o miejscu) – na sesję.
- Wyszukuj informacje o miejscach za pomocą wyszukiwania miejsc. Szczegółowe informacje o cenach znajdziesz w artykule SKU: Find Place.
- Geokodowanie i odwrotne geokodowanie adresów za pomocą Geocoding. Szczegółowe informacje o cenach znajdziesz w artykule SKU: Geocoding.
Jedno dopasowanie lub brak dopasowań
Gdy partner wyszukuje pasujące informacje o lokalizacji, jego celem jest zawężenie wyników wyszukiwania do 1 lub 0 dopasowań. Oznacza to, że lokalizacja pasuje do kryteriów wyszukiwania lub nie istnieje jeszcze w Profilu Firmy.
Jeśli nie ma żadnych dopasowań lub jest tylko jedno, użyj metody accounts.locations.create, aby utworzyć nową wizytówkę, lub postępuj zgodnie z instrukcjami w GoogleLocations, aby zgłosić prawo własności do istniejącej wizytówki. Jeśli Google nie może przypisać kodu geograficznego do adresu, utworzenie lokalizacji nie powiedzie się, a odpowiedź interfejsu API będzie zawierać prośbę o dane LatLng. Informacje o tym, jak sprzedawca może podać dane LatLng, znajdziesz w artykule Ręczne dostosowywanie danych geolokalizacyjnych.
Po określeniu współrzędnych LatLng tworzona jest nowa strona z informacjami.
Częściowe i wielokrotne dopasowania
Gdy właściciel firmy lub zespół operacyjny partnera wyszukuje wizytówki pasujące do lokalizacji, wpisane informacje mogą skutkować tylko częściowym dopasowaniem lub mogą zwrócić wiele wyników pasujących do zapytania. Aby zawęzić wyniki wyszukiwania do jednego dopasowania lub braku dopasowań, częściowe i wielokrotne dopasowania są rozwiązywane ręcznie przez 2 przypadki użycia interfejsu API Map Google.
Użytkownik zawęża wyszukiwanie.
Gdy użytkownik platformy partnera wyszukuje lokalizację i otrzymuje kilka częściowych dopasowań, może rozwiązać ten problem na jeden z tych sposobów:
- Przeanalizuj częściowo pasujące adresy i wybierz właściwy.
- Edytuj lub wpisz ponownie części adresu, aby były dokładniejsze i zawężały wyniki do 1 lub 0 dopasowań.
Użytkownik wybiera spośród co najmniej 1 pełnego dopasowania.
W niektórych przypadkach kilka lokalizacji może w pełni odpowiadać adresowi wyszukiwanemu przez 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 otrzymasz te odpowiedzi, które pasują do podanego adresu:
- Kasperson Printer Center, niezweryfikowana lokalizacja.
- Bengo Seguro, zweryfikowana lokalizacja.
- Garush Productions, niezweryfikowana lokalizacja.
Użytkownik musi ręcznie wybrać pasującą firmę. Aby zapewnić klientom dokładne wskazówki dojazdu do firmy, może być konieczne dostosowanie danych dotyczących szerokości i długości geograficznej (LatLng) tych lokalizacji w celu zwiększenia ich dokładności. Informacje o tym, jak użytkownicy mogą ręcznie wpisać LatLng, znajdziesz w artykule Ręczne dostosowywanie danych geolokalizacyjnych.
Ręczne dostosowywanie danych geolokalizacyjnych
Firmy mogą dodawać współrzędne szerokości i długości geograficznej (LatLng) swojej firmy, aby zwiększyć dokładność informacji w profilu firmy. Nowe firmy mogą nie znać swoich współrzędnych LatLng, więc mogą ręcznie upuścić pinezkę za pomocą widżetu miejsc interfejsu Maps JavaScript API, aby ustalić dokładne współrzędne LatLng.
LatLng, musisz ręcznie dostosować współrzędne każdej lokalizacji.Jakość wyników wyszukiwania
Wyniki wyszukiwania różnią się znacznie w zależności od dokładności wyszukiwanego adresu i regionu geograficznego. W regionach rozwijających się często występuje mniej miejsc na Mapach, a formaty adresów Google są stosowane niespójnie. Prowadzi to do obniżenia jakości wyników wyszukiwania i zwiększenia potrzeby ręcznego formatowania adresów oraz korzystania z interfejsu API Map Google.