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.
| Monatlicher Volumenbereich (Preis pro Anruf) | 0–100.000 | 100.001–500.000 | 500.000+ | |
| Automatische Vervollständigung | 0,00283 USD pro Stück (2,83 USD pro 1000) | 0,00227 USD pro Stück (2,27 USD pro 1000) | Kontaktieren Sie den Vertrieb für Mengenpreise | |
| Abfrageautomatisierung | 0,00283 USD pro Stück(2,83 USD pro 1000) | 0,00227 USD pro Stück (2,27 USD pro 1000) | Kontaktieren Sie den Vertrieb für Mengenpreise | |
| Ortsdetails | 0,017 USD pro Stück(17,00 USD pro 1000) | 0,0136 USD pro Stück (13,60 USD pro 1000) | Kontaktieren Sie den Vertrieb für Mengenpreise | |
| Ortsfoto | 0,007 USD pro Stück (7,00 USD pro 1000) | 0,0056 USD pro Stück (5,60 USD pro 1000) | Kontaktieren Sie den Vertrieb für Mengenpreise | |
| Suche | 0,032 USD pro Stück (32,00 USD pro 1000) | 0,0256 USD pro Stück (25,60 USD pro 1000) | Kontaktieren Sie den Vertrieb für Mengenpreise |
Sie können die Google Places API Dokumentation überprüfen, um weitere Details zu allen Preisen und Beschränkungen zu finden.
FAQ
Ist die Nutzung der Google Places API kostenlos?
Kann ich den API-Schlüssel für die Google Places API auf mehreren Websites verwenden?
Gibt es eine Möglichkeit, die API-Schlüssel zu schützen, um Missbrauch zu verhindern?
Welche Arten von Ortsinformationen kann ich mit der Google Places API abrufen?
Kann ich benutzerdefinierte Kategorien für die Ortsuche festlegen?
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.
