Wie man die Google Places API verwendet und einen API-Schlüssel erhält

Was ist Google Places API

Die Places API ist ein Dienst, der Informationen über Orte mithilfe von HTTP-Anfragen zurückgibt. Orte werden in dieser API in der Regel als Einrichtungen, geografische Standorte oder prominente Sehenswürdigkeiten definiert. 

Es gibt fünf Arten von Anfragen innerhalb der API. Sie sind:

• Ortsuche, die eine Liste von Orten basierend auf dem Standort oder dem Suchbegriff eines Benutzers zurückgibt.
• Ortsdetails, die detaillierte Informationen über einen bestimmten Ort mit Benutzerbewertungen liefert.
• Ortsfotos, gewährt Zugang zu den Millionen von ortsbezogenen Fotos in Googles Places-Datenbank.
• Ortsbewertungen, ermöglicht den Zugriff und das Einbetten von Google-Bewertungen von der Plattform.
• Ortsautomatisierung dient dazu, den Namen oder die Adresse eines Ortes automatisch auszufüllen, während Benutzer tippen.
• Abfrageautomatisierung bietet einen Abfragevorhersagedienst für textbasierte geografische Suchen, der während des Tippens vorgeschlagene Abfragen zurückgibt.

Um mit der Places API zu arbeiten, benötigen Sie einen Schlüssel, der bei jeder Places-API-Anfrage enthalten sein sollte. Lassen Sie uns herausfinden, was es genau ist und wie man den API-Schlüssel für Google Places API erhält. 

Wie man einen Google Places API-Schlüssel erstellt

Der API-Schlüssel ist ein eindeutiger Bezeichner, der dazu dient, Anfragen zu authentifizieren, die mit Ihrem Projekt zu Nutzungszwecken und Abrechnungszwecken verbunden sind. Indem Sie einen API-Schlüssel verwenden, um Anfragen zu authentifizieren, können Sie:

• Verwalten Sie Ihre APIs in der Google Cloud Console.
• Greifen Sie in der Google Cloud Platform Console auf Echtzeitnutzungsdaten und 30 Tage historische Nutzungsdaten zu. 
• Beobachten Sie Nutzungsberichte mit mehr als 30 Tagen Informationen im Google Cloud Support-Portal.

Weitere Informationen zu den Berichten, die für Kunden des Premium-Plans verfügbar sind, finden Sie hier. Nun können Sie mit dem Erhalt des Schlüssels fortfahren. 

Sie sind immer frei, eine alternative Möglichkeit auszuprobieren, Kundenbewertungen auf Ihrer Website hinzuzufügen. Zum Beispiel gibt es das Google Reviews-Widget von Elfsight – Sie müssen sich keine Gedanken über den Erhalt von API-Schlüsseln machen oder Programmieren lernen.

Holen Sie sich Ihren Places API-Schlüssel und fügen Sie ihn zu Ihrer Anfrage hinzu

Um Ihren API-Schlüssel zu erhalten, müssen Sie folgende Schritte ausführen:

• Öffnen Sie die Google Cloud Platform Console.
• Klicken Sie auf die Projekt-Dropdown-Liste und wählen Sie das für Sie erstellte Projekt aus. Der Name sollte mit Google Maps APIs for Business, Google Maps for Work oder Google Maps beginnen.
• Klicken Sie dann auf die Menüschaltfläche und wählen Sie APIs & Dienste > Anmeldeinformationen.
• Auf der Seite Anmeldeinformationen wählen Sie Anmeldeinformationen erstellen > API-Schlüssel. Dort sehen Sie einen API-Schlüssel erstellen Dialog, der Ihren neu erstellten Schlüssel zeigt.
• Schließen Sie das Register. Ihr neuer API-Schlüssel wird auf der Seite Anmeldeinformationen im Abschnitt API-Schlüssel aufgelistet.

Dann müssen Sie den API-Schlüssel zu jeder Places API-Anfrage hinzufügen. Verwenden Sie das folgende Beispiel und ersetzen Sie einfach YOUR_API_KEY durch Ihren API-Schlüssel:

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

Beachten Sie, dass Google dringend empfiehlt, dass Sie Ihren API-Schlüssel einschränken. Die Einschränkungen gewähren zusätzliche Sicherheit und stellen sicher, dass nur autorisierte Anfragen mit Ihrem API-Schlüssel durchgeführt werden.

Wie man den Google Places API-Schlüssel einschränkt

Es gibt zwei Einschränkungen, und Sie müssen beide einrichten. Sie sind:

• Anwendungseinschränkung. Diese Funktion ermöglicht es Ihnen, die Verwendung des API-Schlüssels auf Websites, Webserver oder mobile Apps zu beschränken. Es gibt nur eine Einschränkung aus dieser Kategorie, die ausgewählt werden kann. 
• API-Einschränkung. Diese Art von Einschränkung beschränkt die Verwendung des API-Schlüssels auf eine oder mehrere APIs oder SDKs. 

Um Ihren API-Schlüssel einzuschränken, müssen Sie Folgendes tun:

• Öffnen Sie die Google Cloud Console.
• Klicken Sie auf die Projekt-Dropdown-Liste und wählen Sie das Projekt aus, das den zu sichernden API-Schlüssel enthält.
• Klicken Sie auf die Menüschaltfläche und wählen Sie APIs & Dienste > Anmeldeinformationen.
• Klicken Sie auf den Namen des API-Schlüssels, den Sie sichern möchten, auf der Seite Anmeldeinformationen. 
• Richten Sie die Beschränkungen auf der Seite API-Schlüssel einschränken und umbenennen ein. 

Nachdem die Einschränkungen festgelegt sind, müssen Sie nur noch auf die Schaltfläche Speichern klicken. 

Verwendung von Google Places API: Beispiele

Es gibt mehrere Möglichkeiten, die Google Places API zu verwenden. Lassen Sie uns einige davon sehen.

Ortsuche

Wie oben erwähnt, ermöglicht es die Places API, nach Ortsinformationen in einer Vielzahl von Kategorien zu suchen. Das folgende Google Places API-Beispiel zeigt eine Suchanfrage für den „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

Ortsdetails

Sobald Sie eine place_id aus einer Google Places-Suche erhalten haben, können Sie weitere Informationen über eine bestimmte Einrichtung oder Sehenswürdigkeit abrufen, indem Sie eine Ortsdetails-Anfrage initiieren. Hier sehen wir eine Anfrage nach Details eines Ortes anhand der 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

Ortsfotos

Dieser Dienst ermöglicht es Ihnen, Fotoinhalte zu Ihren Anwendungen hinzuzufügen. Er gewährt Zugriff auf Millionen von Fotos, die in der Places-Datenbank von Google gespeichert sind. Hier ist ein Beispiel für eine Anfrage:

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

Ortsautomatisierung

Es ist ein Webdienst, der Ortsvorhersagen als Antwort auf eine HTTP-Anfrage zurückgibt. Er kann verwendet werden, um eine automatische Vervollständigungsfunktion für textbasierte geografische Suchen bereitzustellen. Hier ist ein Beispiel für eine Anfrage für Einrichtungen:

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

Abfrageautomatisierung

Dieser Dienst wird verwendet, um eine Abfragevorhersage für textbasierte geografische Suchen bereitzustellen, indem vorgeschlagene Abfragen zurückgegeben werden, während ein Benutzer tippt. Eine Beispielanfrage sieht so aus:

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

Preisgestaltung und Beschränkungen der Google Places API

Google verwendet hier ein Preismodell nach Verbrauch. Dies bedeutet, dass die Google Maps Platform APIs nach SKU abgerechnet werden. Die Nutzung wird für jede Product SKU verfolgt, und eine API kann mehr als eine Product SKU haben. 

Es gibt 1.000 kostenlose Places-API-Suchvorgänge pro 24 Stunden, aber Sie können sie auf 150.000 kostenlose Suchvorgänge pro 24 Stunden erhöhen, indem Sie die Abrechnung in der Google Cloud Console aktivieren. 

Sie können die Google Places API Dokumentation überprüfen, um weitere Details zu allen Preisen und Beschränkungen zu finden. 

FAQ

Fazit

Die Google Places API bietet eine leistungsstarke Möglichkeit, Ortsinformationen in Ihre Anwendungen zu integrieren. Mit verschiedenen Arten von Anfragen können Sie detaillierte Informationen über Orte abrufen, Fotos anzeigen, Vorhersagen für automatische Vervollständigung erhalten und vieles mehr. Durch die Verwendung von API-Schlüsseln können Sie Ihre Anfragen authentifizieren und die Nutzung Ihrer Anwendungen verfolgen. Mit der richtigen Integration können Sie Ihren Benutzern eine nahtlose Erfahrung bieten und gleichzeitig wertvolle Ortsinformationen nutzen.

Wenn Sie weitere Fragen zur Verwendung der Google Places API haben, sollten Sie sich die offizielle Dokumentation ansehen, in der weitere Informationen und Beispiele zur Verfügung stehen.