Place Details

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Plattform auswählen: Android iOS JavaScript Webdienst

Das Places SDK for iOS bietet Ihrer App umfangreiche Informationen zu Orten, z. B. den Namen und die Adresse des Orts, den als Breiten- und Längengrad bezeichneten geografischen Standort und die Art des Orts (z. B. Nachtclub, Tierhandlung oder Museum). Um auf diese Informationen für einen bestimmten Ort zuzugreifen, können Sie die Orts-ID verwenden, eine stabile Kennung, die einen Ort eindeutig bezeichnet.

Ortsdetails

Die Klasse GMSPlace enthält Informationen zu einem bestimmten Ort. Sie können ein GMSPlace-Objekt auf folgende Weise abrufen:

Ortsfelder

Wenn Sie einen Ort anfordern, müssen Sie angeben, welche Arten von Ortsdaten zurückgegeben werden sollen. Übergeben Sie dazu einen GMSPlaceField und geben Sie die Datentypen an, die zurückgegeben werden sollen. Dies ist ein wichtiger Faktor, da sich dies auf die Kosten für jede Anfrage auswirkt. Da Ortsergebnisdaten nicht leer sein dürfen, werden nur Ortsergebnisse mit Daten zurückgegeben. Wenn beispielsweise ein angeforderter Ort keine Fotos hat, ist das Feld photos nicht im Ergebnis enthalten. Sie können eines oder mehrere der folgenden Felder angeben:

  • GMSPlaceFieldName
  • GMSPlaceFieldPlaceID
  • GMSPlaceFieldPlusCode
  • GMSPlaceFieldBusinessStatus
  • GMSPlaceFieldCoordinate
  • GMSPlaceFieldOpeningHours
  • GMSPlaceFieldPhoneNumber
  • GMSPlaceFieldFormattedAddress
  • GMSPlaceFieldRating
  • GMSPlaceFieldPriceLevel
  • GMSPlaceFieldTypes
  • GMSPlaceFieldWebsite
  • GMSPlaceFieldViewport
  • GMSPlaceFieldAddressComponents
  • GMSPlaceFieldPhotos
  • GMSPlaceFieldUserRatingsTotal
  • GMSPlaceFieldIconImageURL
  • GMSPlaceFieldIconBackgroundColor
  • GMSPlaceFieldUTCOffsetMinutes
  • GMSPlaceFieldAll

Weitere Informationen zu Ortsfeldern Weitere Informationen zur Abrechnung von Ortsdatenanfragen finden Sie unter Nutzung und Abrechnung.

Die Klasse GMSPlace kann die folgenden Ortsdaten enthalten:

  • name: Der Name des Orts
  • placeID: Die Textkennung für den Ort. Weitere Informationen zu Orts-IDs finden Sie weiter unten auf dieser Seite.
  • coordinate: Der geografische Standort des Orts, angegeben in Breiten- und Längengraden.
  • businessStatus: Der Betriebsstatus des Orts, wenn es sich um ein Unternehmen handelt. Er kann einen der folgenden Werte enthalten: GMSBusinessStatusOperational, GMSBusinessStatusClosedTemporarily, GMSBusinessStatusClosedPermanently, GMSBusinessStatusUnknown.
  • phoneNumber: Die Telefonnummer des Orts im internationalen Format.
  • formattedAddress: Die menschenlesbare Adresse dieses Standorts.

    Oft entspricht diese Adresse der Postanschrift. In einigen Ländern wie dem Vereinigten Königreich ist die Weitergabe echter Postanschriften aufgrund von Lizenzbeschränkungen nicht zulässig.

    Die formatierte Adresse besteht logisch aus einer oder mehreren Adresskomponenten. Die Adresse & #118; Beispiel: 8th Avenue, New York, NY&#;

    Parsen Sie die formatierte Adresse nicht programmatisch. Verwende stattdessen die einzelnen Adresskomponenten, die in der API-Antwort zusätzlich zum formatierten Adressfeld enthalten sind.

  • rating: Eine aggregierte Bewertung des Orts, die als Gleitkommazahl mit einem Wert zwischen 1,0 und 5,0 zurückgegeben wird, basierend auf den aggregierten Nutzerrezensionen.
  • openingHours: Die Öffnungszeiten für den Ort (wie durch GMSOpeningHours dargestellt). Rufen Sie GMSOpeningHours.weekdayText auf, um eine Liste der lokalisierten Strings der täglichen Öffnungszeiten für die Woche zu erhalten. Rufen Sie GMSOpeningHours.Periods auf, um eine Liste von GMSPeriods mit detaillierteren Informationen zurückzugeben, die den von weekdayText bereitgestellten Daten entsprechen. Hinweis: Wenn ein Ort immer geöffnet ist, wird der Zeitraum als Sonntag um Mitternacht angegeben und closeEvent ist null.
  • plusCode: Die Plus Code-Darstellung des Orts für den Ort.
  • priceLevel: Die Preisebene für diesen Ort, zurückgegeben als Ganzzahl mit Werten von 0 (günstig) bis 4 (teuer).
  • types: Eine Liste von Ortstypen, die diesen Ort beschreiben. Dieses Array kann mehrere Werte enthalten oder leer sein. Neue Werte können ohne vorherige Ankündigung eingeführt werden. Hier finden Sie eine Liste der unterstützten Typen.
  • website: Der URI der Website des Orts, falls bekannt. Das ist die Website, die vom Unternehmen oder einer anderen mit dem Ort verknüpften Rechtspersönlichkeit verwaltet wird.
  • attributions: Eine NSAttributedString mit den Attributionen, die dem Nutzer angezeigt werden müssen, wenn deine App Ortsdetails aus dem Places SDK for iOS verwendet. Weitere Informationen zum Abrufen und Anzeigen von Quellenangaben findest du im Leitfaden zu Quellenangaben.
  • addressComponents: Ein Array mit GMSAddressComponent-Objekten, die Komponenten der Adresse für einen Ort darstellen. Sie dienen dazu, strukturierte Informationen über die Adresse eines Orts zu extrahieren, z. B. die Stadt, in der sich ein Ort befindet. Verwende diese Komponenten nicht für die Adressformatierung. Verwende stattdessen die Property formattedAddress, die eine lokalisierte formatierte Adresse bietet.

    Beachten Sie die folgenden Fakten zum Array addressComponents:

    • Das Array der Adresskomponenten kann mehr Komponenten als formattedAddress enthalten.
    • Das Array enthält nicht unbedingt alle politischen Entitäten, die eine Adresse enthalten. Ausgenommen hiervon sind die im formattedAddress enthaltenen.
    • Es kann nicht garantiert werden, dass das Format der Antwort bei Anfragen gleich bleibt. Insbesondere die Anzahl der addressComponents variiert je nach angeforderter Adresse und kann sich im Laufe der Zeit für dieselbe Adresse ändern. Eine Komponente kann die Position im Array ändern. Der Typ der Komponente kann sich ändern. Eine bestimmte Komponente fehlt möglicherweise in einer späteren Antwort.
  • userRatingsTotal: Gibt an, wie viele Rezensionen die Bewertung des Orts ausmachen.
  • GMSPlaceFieldIconImageURL: Die URL eines Symbols für den Ortstyp (PNG-Format).
  • GMSPlaceFieldIconBackgroundColor: Die Hintergrundfarbe des Symbols für den Ortstyp.
  • UTCOffsetMinutes: Die Zeitzonenverschiebung des Orts in Minuten.

Die Klasse GMSPlace enthält die folgenden Mitgliederfunktionen:

  • isOpen berechnet anhand von openingHours und UTCOffsetMinutes sowie dem aktuellen Datum und der Uhrzeit, ob ein Ort zum angegebenen Zeitpunkt geöffnet ist.
  • isOpenAtDate berechnet anhand von openingHours und UTCOffsetMinutes sowie dem aktuellen Datum und der Uhrzeit, ob ein Ort an einem bestimmten Datum geöffnet ist.
  • Wenn Sie diese Funktionen zum Abrufen von Öffnungszeiten und/oder Datumsangaben verwenden, müssen in der ursprünglichen Anfrage fetchPlaceFromPlaceID: oder findPlaceLikelihoodsFromUserLocationWithPlaceFields: die Felder GMSPlaceFieldOpeningHours und GMSPlaceFieldUTCOffsetMinutes angegeben werden. Wenn eines dieser Felder fehlt, enthält das resultierende GMSPlace-Objekt keine Öffnungszeiten oder Datumsangaben und der Aufruf gibt GMSPlaceOpenStatusUnknown zurück. Fordern Sie die Felder GMSPlaceFieldBusinessStatus und GMSPlaceFieldUTCOffsetMinutes in Ihrer ursprünglichen Ortsanfrage an, um genaue Ergebnisse zu erhalten. Wenn dies nicht angefordert wird, wird davon ausgegangen, dass das Unternehmen betriebsbereit ist.

    In diesem Video erfahren Sie, wie Sie isOpen mit Place Details verwenden.

Ort nach ID anfordern

Die Orts-ID ist eine ID in Textform, mit der ein Ort eindeutig bezeichnet wird. Im Places SDK for iOS können Sie die ID eines Orts aus einem GMSPlace-Objekt abrufen. Sie können die Orts-ID speichern und verwenden, um das Objekt GMSPlace später noch einmal abzurufen.

Um einen Ort nach ID abzurufen, rufen Sie GMSPlacesClient fetchPlaceFromPlaceID: auf und übergeben Sie dabei die folgenden Parameter:

  • Ein String mit einer Orts-ID.
  • Ein oder mehrere GMSPlaceFields, die die Datentypen angeben, die zurückgegeben werden sollen.
  • Ein Sitzungstoken, wenn der Aufruf zum Abschluss einer Autocomplete-Abfrage gesendet wird. Andernfalls übergeben Sie nil.
  • Ein GMSPlaceResultCallback, um das Ergebnis zu verarbeiten.

Die API ruft die angegebene Callback-Methode auf und übergibt ihr ein GMSPlace-Objekt. Wird der Ort nicht gefunden, hat das Objekt „place“ den Wert null.

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
  UInt(GMSPlaceField.placeID.rawValue))!

placesClient?.fetchPlace(fromPlaceID: placeId, placeFields: fields, sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    self.lblName?.text = place.name
    print("The selected place is: \(place.name)")
  }
})

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeId = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);

[_placesClient fetchPlaceFromPlaceID:placeId placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    NSLog(@"The selected place is: %@", [place name]);
  }
}];

Zuordnungen in der App anzeigen

Wenn deine App Informationen aus GMSPlacesClient lookUpPlaceID:callback: anzeigt, muss sie auch Quellenangaben enthalten. Weitere Informationen finden Sie in der Dokumentation zu Quellenangaben.

Aus unseren Nutzungsbedingungen

Nur Google-Daten
mit Google Maps verwenden

Wenn Sie Google-Daten nutzen, verwenden Sie sie ausschließlich mit Google Maps. Du kannst Google-Daten und Daten von anderen Anbietern auf einer Google-Karte darstellen, nur nicht Google-Daten auf Karten, die nicht von Google stammen.

Weitere Informationen

Weitere Informationen zu Orts-IDs

Die im Places SDK for iOS verwendete Orts-ID ist dieselbe Kennung wie die Places API, Places SDK for Android und andere Google APIs.

Jede Orts-ID kann sich nur auf einen Ort beziehen, ein Ort kann jedoch mehr als eine Orts-ID haben.

Es kann vorkommen, dass ein Ort eine neue Orts-ID erhält. Zum Beispiel kann dies der Fall sein, wenn ein Unternehmen seinen Sitz verlagert.

Wenn du einen Ort über die Angabe einer Orts-ID anforderst, kannst du sicher sein, dass du immer denselben Ort in der Antwort erhältst (sofern der Ort noch existiert). Die Antwort kann jedoch eine Orts-ID enthalten, die sich von der in Ihrer Anfrage unterscheidet.

Weitere Informationen finden Sie unter Place ID – Übersicht.