Mit den Business Profile 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. Sie können die Inhaberschaft eines Standorts bestätigen und einen Standort anhand seines Breiten- und Längengrads genau auf der Karte platzieren.
Hinweis
Sie können die Business Profile APIs erst verwenden, nachdem Sie Ihre Anwendung registriert und OAuth 2.0-Anmeldedaten abgerufen haben. Weitere Informationen zu den ersten Schritten mit den Business Profile 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 APIs und die entsprechenden Ressourcen verwenden: die Business Profile 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 Maps-APIs an:
- Vervollständigungen von Orten werden mit den Diensten zur automatischen Vervollständigung von Orten und zum Abrufen von Ortsdetails der Places API zurückgegeben. Informationen zu Preisen finden Sie hier.
- Mit der Funktion zur Suche nach Orten der Places API können Sie Informationen zu Orten abfragen. Informationen zu Preisen finden Sie hier.
- Mit der Geocoding API ist das Geocoding und die umgekehrte Geocodierung von Adressen möglich. Informationen zu Preisen finden Sie hier.
Eine oder keine Übereinstimmung
Partner, die nach übereinstimmenden Einträgen für einen Standort suchen, möchten, dass eine oder keine Übereinstimmung als Ergebnis zurückgegeben wird. Das heißt, der Standort entspricht 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 Genauigkeit 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 genaue Routen zum Unternehmen erhalten, müssen die Breiten- und Längengrade (LatLng) für diese Standorte eventuell angepasst werden, um eine höhere Genauigkeit zu erreichen. 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 Genauigkeit des Eintrags in Google Unternehmensprofil zu verbessern. Neue Unternehmen kennen ihre LatLng-Koordinaten eventuell nicht. Sie können 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 Genauigkeit der gesuchten Adresse und der 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.