Jak korzystać z Google Places API i uzyskać klucz API

Czym jest Google Places API

Places API to usługa zwracająca informacje o miejscach za pomocą zapytań HTTP. Miejsca w tym API zwykle definiowane są jako obiekty, lokalizacje geograficzne lub ważne punkty zainteresowania. 

W API dostępnych jest pięć typów zapytań. Są to:

• Wyszukiwanie miejsc, które zwraca listę miejsc na podstawie lokalizacji użytkownika lub wpisanego zapytania.
• Szczegóły miejsca, które dostarczają szczegółowych informacji o konkretnym miejscu, w tym opinii użytkowników.
• Zdjęcia miejsc, które umożliwiają dostęp do milionów zdjęć związanych z miejscami przechowywanych w bazie Google Places.
• Opinie o miejscach, które pozwalają na pobieranie i osadzanie opinii Google z platformy.
• Autouzupełnianie miejsc, które automatycznie uzupełnia nazwę lub adres miejsca podczas wpisywania przez użytkownika.
• Autouzupełnianie zapytań, które przewiduje zapytania tekstowe dotyczące lokalizacji, zwracając sugestie podczas wpisywania.

Aby korzystać z Places API, potrzebny jest klucz, który należy dołączać do każdego zapytania. Sprawdźmy, czym dokładnie jest ten klucz i jak go zdobyć dla Google Places API. 

Jak utworzyć klucz Google Places API

Klucz API to unikalny identyfikator służący do uwierzytelniania zapytań powiązanych z Twoim projektem w celach rozliczeniowych i użytkowych. Korzystając z klucza API do uwierzytelniania, możesz:

• Zarządzać swoimi API w Google Cloud Console.
• Uzyskać dostęp do danych o bieżącym użyciu oraz do 30-dniowej historii w Google Cloud Platform Console. 
• Przeglądać raporty użycia z danymi sięgającymi ponad 30 dni w Google Cloud Support Portal.

Więcej informacji o raportach dostępnych dla klientów Planu Premium znajdziesz tutaj. Teraz możesz przejść do uzyskania klucza. 

Możesz też wypróbować alternatywny sposób dodawania opinii klientów na swojej stronie. Na przykład, dostępny jest widżet Google Reviews od Elfsight – nie musisz martwić się o klucze API ani uczyć się programowania.

Pobierz klucz Places API i dodaj go do swojego zapytania

Aby uzyskać klucz API, wykonaj następujące kroki:

• Otwórz Google Cloud Platform Console.
• Kliknij listę rozwijaną projektów i wybierz projekt utworzony dla Ciebie. Nazwa powinna zaczynać się od Google Maps APIs for Business, Google Maps for Work lub Google Maps.
• Następnie kliknij przycisk menu i wybierz API i usługi > Dane uwierzytelniające.
• Na stronie Dane uwierzytelniające wybierz Utwórz dane uwierzytelniające > Klucz API. Zobaczysz wtedy okno dialogowe z nowo utworzonym kluczem.
• Zamknij kartę. Nowy klucz API będzie widoczny na stronie danych uwierzytelniających w sekcji Klucze API.

Następnie musisz dodać klucz API do każdego zapytania Places API. W poniższym przykładzie zastąp YOUR_API_KEY swoim kluczem:

https://maps.googleapis.com/maps/api/place/nearbysearch/json  ?location=-33.8670522,151.1957362  &radius=500  &types=food  &name=harbour  &key=YOUR_API_KEY

Pamiętaj, że Google zdecydowanie zaleca ograniczenie dostępu do klucza API. Ograniczenia zwiększają bezpieczeństwo i pomagają zapewnić, że tylko autoryzowane zapytania będą wykonywane z użyciem Twojego klucza.

Jak ograniczyć dostęp do klucza Google Places API

Istnieją dwa rodzaje ograniczeń, które musisz ustawić. Są to:

• Ograniczenie aplikacji. Pozwala ograniczyć użycie klucza API do stron internetowych, serwerów WWW lub aplikacji mobilnych. Można wybrać tylko jedno ograniczenie z tej kategorii. 
• Ograniczenie API. Ogranicza użycie klucza API do jednego lub więcej określonych API lub SDK. 

Aby ustawić ograniczenia klucza API, wykonaj:

• Otwórz Google Cloud Console.
• Kliknij listę rozwijaną projektów i wybierz projekt zawierający klucz API, który chcesz zabezpieczyć.
• Kliknij menu i wybierz API i usługi > Dane uwierzytelniające.
• Kliknij nazwę klucza API, który chcesz zabezpieczyć na stronie danych uwierzytelniających. 
• Ustaw ograniczenia na stronie Ogranicz i zmień nazwę klucza API. 

Po ustawieniu ograniczeń wystarczy kliknąć przycisk Zapisz. 

Przykłady użycia Google Places API

Google Places API można wykorzystać na kilka sposobów. Spójrzmy na niektóre z nich.

Wyszukiwanie miejsc

Jak wspomniano wcześniej, Places API pozwala wyszukiwać informacje o miejscach w wielu kategoriach. Poniższy przykład pokazuje zapytanie Find Place dla „Museum of Contemporary Art Australia”:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

Szczegóły miejsca

Po uzyskaniu place_id z wyszukiwania Google Places możesz pobrać więcej informacji o danym obiekcie lub punkcie zainteresowania, wykonując zapytanie o szczegóły miejsca. Oto przykład zapytania o szczegóły miejsca po place_id: 

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY

Zdjęcia miejsc

Ta usługa pozwala dodać zdjęcia do Twoich aplikacji. Umożliwia dostęp do milionów zdjęć przechowywanych w bazie Places. Oto przykład zapytania:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Autouzupełnianie miejsc

To usługa sieciowa zwracająca przewidywania miejsc w odpowiedzi na zapytanie HTTP. Może być używana do autouzupełniania tekstowych wyszukiwań geograficznych. Oto przykład zapytania dla obiektów:

https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY

Autouzupełnianie zapytań

Ten typ usługi służy do przewidywania zapytań tekstowych dotyczących lokalizacji, zwracając sugestie podczas wpisywania. Przykładowe zapytanie wygląda tak:

https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par

Cennik i limity Google Places API

Google stosuje model płatności za rzeczywiste użycie. Oznacza to, że API Google Maps Platform są rozliczane według SKU. Użycie jest śledzone dla każdego SKU produktu, a jedno API może mieć więcej niż jedno SKU. 

Dostępnych jest 1000 darmowych zapytań Places API na 24 godziny, ale możesz zwiększyć ten limit do 150 000 darmowych zapytań na 24 godziny, włączając rozliczenia w Google Cloud Console. 

Więcej szczegółów o cenach i limitach znajdziesz w dokumentacji Google Place API. 

FAQ

Podsumowanie

Teraz masz już wiedzę, jak uzyskać klucz Google Maps Places API. Jak zauważyłeś, jest to bardzo proste i zajmuje zwykle nie więcej niż 5 minut. Jedyną rzeczą, którą powinieneś wiedzieć przed rozpoczęciem, jest rodzaj API, z którym planujesz pracować.