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.
Zakres miesięcznego wolumenu (Cena za ZAPYTANIE) | 0–100 000 | 100 001–500 000 | powyżej 500 000 | |
Autouzupełnianie | 0,00283 USD za każde (2,83 USD za 1000) | 0,00227 USD za każde (2,27 USD za 1000) | Skontaktuj się z działem sprzedaży w sprawie cen hurtowych | |
Autouzupełnianie zapytań | 0,00283 USD za każde (2,83 USD za 1000) | 0,00227 USD za każde (2,27 USD za 1000) | Skontaktuj się z działem sprzedaży w sprawie cen hurtowych | |
Szczegóły miejsc | 0,017 USD za każde (17,00 USD za 1000) | 0,0136 USD za każde (13,60 USD za 1000) | Skontaktuj się z działem sprzedaży w sprawie cen hurtowych | |
Zdjęcia miejsc | 0,007 USD za każde (7,00 USD za 1000) | 0,0056 USD za każde (5,60 USD za 1000) | Skontaktuj się z działem sprzedaży w sprawie cen hurtowych | |
Wyszukiwanie | 0,032 USD za każde (32,00 USD za 1000) | 0,0256 USD za każde (25,60 USD za 1000) | Skontaktuj się z działem sprzedaży w sprawie cen hurtowych |
Więcej szczegółów o cenach i limitach znajdziesz w dokumentacji Google Place API.
FAQ
Czy Google Places API jest usługą darmową?
Places API działa w modelu płatności za rzeczywiste użycie. Szczegóły cen znajdziesz w powyższej tabeli lub w dokumentacji.
Jak mogę korzystać z Google Places API?
Aby to zrobić, musisz uzyskać klucz API. Możesz to zrobić w swoim Cloud Console, klikając listę rozwijaną projektów i wybierając projekt utworzony dla Ciebie.
Jak dodać lub edytować miejsca?
Jeśli jesteś właścicielem firmy, możesz to zrobić na Google Maps za pomocą Google My Business. Jeśli nie jesteś właścicielem miejsca, możesz zasugerować zmiany.
Jak zacząć korzystać z API na mojej stronie?
Najpierw musisz określić, które API dokładnie potrzebujesz. Przejrzyj przewodniki Overview, Developer i Get Started dla konkretnego API lub SDK, którym jesteś zainteresowany.
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ć.