Mit den Google Unternehmensprofil-APIs können Sie eine Plattform erstellen, auf der Ihre Händler ihr Unternehmen auf Google verwalten können. Auf der Plattform können Sie Partnern die Möglichkeit geben, anhand des Namens, der Adresse und der Telefonnummern ihres Unternehmens nach übereinstimmenden Einträgen zu suchen. Anschließend können die Partner die Inhaberschaft eines gefundenen Standorts bestätigen oder diesen anhand seines Breiten- und Längengrads genau auf der Karte platzieren.
Hinweis
Sie können die Google Unternehmensprofil-APIs erst verwenden, nachdem Sie Ihre Anwendung registriert und OAuth 2.0-Anmeldedaten abgerufen haben. Weitere Informationen zu den ersten Schritten mit den Google Unternehmensprofil-APIs finden Sie unter Grundlegende Einrichtung.
Mit Adressdaten arbeiten
Für die Arbeit mit Adress- und Standortbestimmungsdaten auf Ihrer Plattform können Sie zwei verschiedene Gruppen von APIs und die entsprechenden Ressourcen verwenden: die Google Unternehmensprofil-APIs und die Google Maps API.
Häufig verwendete Google Unternehmensprofil-Ressourcen
Mit der GoogleLocations API kann der Händler im Voraus sehen, ob ein Standort bereits in Google Unternehmensprofil beansprucht wurde. Falls nicht, kann er umgehend Zugriff darauf anfordern.
Das Objekt PostalAddress stellt die physische Adresse eines Unternehmens dar.
Häufig verwendete Google Maps-Ressourcen
Partner verwenden die Places Widgets der Maps JavaScript API häufig in ihren Workflows, um interaktive Karten zu erstellen. Darüber hinaus bietet sich die Nutzung der folgenden Google Maps-APIs an:
- Vervollständigungen von Orten werden mit den Places API-Diensten Place Autocomplete und Place Details zum Abrufen von Ortsdetails zurückgegeben. Informationen zu Preisen finden Sie hier.
- Mit der Funktion Place Search der Places API können Sie Informationen zu Orten abfragen. Informationen zu Preisen finden Sie hier.
- Die Geocoding API ermöglicht das Geocoding und dessen Umkehrung, d. h. die Umwandlung von geografischen Koordinaten in Adressen. Informationen zu Preisen finden Sie hier.
Eine oder keine Übereinstimmung
Partner, die nach passenden Einträgen für einen Standort suchen, möchten in der Regel, dass eine oder keine Übereinstimmung als Ergebnis zurückgegeben wird. Das heißt, der Standort entspricht entweder den Suchkriterien oder ist noch nicht in Google Unternehmensprofil vorhanden.
Wenn es eine oder keine Übereinstimmung gibt, können Sie die Methode accounts.locations.create verwenden und einen neuen Eintrag erstellen oder der Anleitung für GoogleLocations folgen und Anspruch auf den vorhandenen Eintrag erheben. Wenn Google keine Koordinaten für die Adresse generieren kann, schlägt die Erstellung des Standorts fehl. Die API-Antwort enthält dann eine Anfrage nach LatLng-Daten. Informationen dazu, wie Händler ihre LatLng-Daten bereitstellen können, finden Sie unter Manuelle Anpassung der Daten zur Standortbestimmung.
Sobald die LatLng-Koordinaten ermittelt wurden, wird der neue Eintrag erstellt.
Teilübereinstimmungen und mehrere Übereinstimmungen
Wenn ein Geschäftsinhaber oder das Operations-Team des Partners nach Einträgen für einen Standort sucht, kann es passieren, dass die Suchanfrage nur eine Teilübereinstimmung oder aber mehrere Übereinstimmungen zum Ergebnis hat. Es gibt zwei Möglichkeiten, die Suchergebnisse in diesem Fall mithilfe der Maps API auf eine oder keine Übereinstimmung einzugrenzen.
Nutzer grenzen die Suche ein
Wenn ein Nutzer der Partnerplattform nach einem Standort sucht und mehrere Teilübereinstimmungen zurückgegeben werden, kann er Folgendes tun:
- Aus den Adressen, die teilweise übereinstimmen, die richtige aussuchen
- Die Adresse bearbeiten oder teilweise neu eingeben, um die Treffsicherheit zu erhöhen und die Ergebnisse auf eine oder keine Übereinstimmung einzugrenzen
Nutzer wählen aus einer oder mehreren vollständigen Übereinstimmungen aus
In einigen Fällen stimmen unter Umständen mehrere Standorte vollständig mit der Suchadresse des Nutzers überein. Angenommen, ein Nutzer gibt folgende Adresse in einer Partnerplattform ein:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Es werden folgende Ergebnisse angezeigt, die alle mit der eingegebenen Adresse übereinstimmen:
- Kasperson Printer Center, ein nicht bestätigter Standort
- Bengo Seguro, ein bestätigter Standort
- Garush Productions, ein nicht bestätigter Standort
Der Nutzer muss das richtige Unternehmen manuell auswählen. Damit Nutzer korrekte Routen zum Unternehmen erhalten, müssen die Breiten- und Längengrade (LatLng) für diese Standorte eventuell angepasst werden, um die realen Verhältnisse besser abzubilden. Informationen dazu, wie Nutzer LatLng manuell eingeben können, finden Sie unter Manuelle Anpassung der Daten zur Standortbestimmung.
Manuelle Anpassung der Daten zur Standortbestimmung
Unternehmen können die Breiten- und Längengrade (LatLng) ihres Standorts hinzufügen, um die Korrektheit des Eintrags in Google Unternehmensprofil zu verbessern. Neue Unternehmen kennen ihre LatLng-Koordinaten eventuell nicht. Sie können deshalb das Places Widget der Maps JavaScript API verwenden, um den Standort manuell auf der Karte zu markieren und korrekte LatLng-Koordinaten zu erhalten.
LatLng-Koordinaten besser zugeordnet werden kann, ist eine manuelle Anpassung der Koordinaten jedes einzelnen Standorts erforderlich.Qualität der Suchergebnisse
Die Qualität der Suchergebnisse kann je nach Korrektheit der gesuchten Adresse und je nach Region stark variieren. In Entwicklungsregionen werden oft weniger Maps-Orte angezeigt. Außerdem werden die Vorgaben von Google für Adressformate dort nicht immer eingehalten. Das hat schlechtere Suchergebnisse zur Folge. Außerdem müssen Nutzer Adressen häufiger manuell formatieren und die Maps API verwenden.