Lokalizacje Google

Interfejs GoogleLocations API pozwala z wyprzedzeniem sprawdzić, czy do profilu firmy zgłoszono prawa do lokalizacji. Dzięki temu do wybranej lokalizacji możesz od razu poprosić o dostęp. Jeśli zarządzasz kontami zweryfikowanymi zbiorczo, możesz z wyprzedzeniem wybrać potencjalne dopasowania i uniknąć tworzenia duplikatów lokalizacji.

Punkt końcowy interfejsu API zwraca adres URL wskazujący, czy dana lokalizacja została już zarezerwowana. Jeśli zgłoszono prawa, ten sam adres URL umożliwia rozpoczęcie procesu wysyłania prośby o dostęp.

Poniższa ilustracja procesu przedstawia prawo własności do lokalizacji.

Rysunek 1. Schemat pływania dotyczący właściciela lokalizacji Profilu Firmy

Aby móc korzystać z interfejsu API GoogleLocations, możesz wykonać te czynności:

  1. Zbieraj dane o lokalizacji od sprzedawcy.

  2. Wywołaj punkt końcowy googleLocations.search. Podaj dane dotyczące lokalizacji w treści rozmowy. Możesz też podać go w ciągu zapytania, podobnie jak użytkownik wpisuje w wyszukiwarce lub Mapach Google. np. &"Starbucks 5th ave NYC."

    Interfejs API zwraca listę potencjalnie pasujących lokalizacji i informacji o każdej lokalizacji, np. adresu locationName i adresu.

  3. Wybierz lokalizację, która odpowiada Twojej lokalizacji. W przypadku braku dopasowań zadzwoń do accounts.locations.create i przejdź do kroku 5.

  4. Na podstawie stanu requestAdminRightsUrl w odpowiedzi wykonaj te czynności:

    1. Jeśli domena requestAdminRightsUrl istnieje, inny użytkownik jest jej właścicielem. Przekieruj sprzedawcę do adresu URL, aby rozpocząć prośbę o dostęp i własność do istniejącej lokalizacji w Profilu Firmy.
    2. Jeśli requestAdminRightsUrl nie istnieje, zadzwoń do accounts.locations.create i utwórz nową wizytówkę, która zostanie zweryfikowana później.
  5. Jeśli w ramach tego procesu utworzysz nowe wizytówki, możesz skorzystać z interfejsów API weryfikacji, aby rozpocząć ich weryfikację. Więcej informacji znajdziesz w artykule Zarządzanie weryfikacją.