Places SDK for iOS (新版) 可為您的應用程式提供豐富的資訊 地點的相關資訊,包括地點的名稱和地址、 指定經緯度座標的位置,以及地點類型 (例如 例如夜店、寵物店、博物館等如要存取這項資訊 特定地點時,您可以使用地點 ID,這是能明確定義 識別地點。
取得 Place Details
GMSPlace
敬上
類別包含特定地點的相關資訊,包括所有顯示在
地點資料欄位 (新)。取得
GMSPlace
敬上
方法是呼叫
GMSPlacesClient
fetchPlaceWithRequest:
,
傳遞 GMSFetchPlaceRequest
物件
類型的回呼方法
GMSPlaceResultCallback
。
GMSFetchPlaceRequest
物件會指定:
- (必要) 地點 ID,這是 Google 地方資訊中地點的專屬 ID 資料庫和 Google 地圖的資訊
- (必要)
GMSPlace
物件中要傳回的欄位清單,也稱為 欄位遮罩,如GMSPlaceProperty
。 如果您未在欄位清單中指定至少一個欄位,或 欄位清單,則呼叫會傳回錯誤。 - (選填) 用來設定回應格式的區碼。
- (選用) 用來結束 Autocomplete (新版) 工作階段的工作階段符記。
提出 Place Details 要求
本範例會透過 ID 取得地點,並傳送下列參數:
ChIJV4k8_9UodTERU5KXbkYpSYs
的地點 ID。- 指定傳回地點名稱和網站網址的欄位清單。
GMSPlaceResultCallback
來處理結果
API 會叫用指定的回呼方法,並傳入
GMSPlace
敬上
物件。如果找不到地點,則地點物件為「nil」。
Swift
// A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Specify the place data types to return. let myProperties = [GMSPlaceProperty.name, GMSPlaceProperty.website].map {$0.rawValue} // Create the GMSFetchPlaceRequest object. let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties, sessionToken: nil) client.fetchPlace(with: fetchPlaceRequest, callback: { (place: GMSPlace?, error: Error?) in guard let place, error == nil else { return } print("Place found: \(String(describing: place.name))") })
Objective-C
// A hotel in Saigon with an attribution. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; // Specify the place data types to return. NSArray<NSString *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite]; // Create the GMSFetchPlaceRequest object. GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties sessionToken:nil]; [placesClient fetchPlaceWithRequest: fetchPlaceRequest callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) { if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } else { NSLog(@"Place Found: %@", place.name); NSLog(@"The place URL: %@", place.website); } }];
GooglePlacesSwift
// A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" let fetchPlaceRequest = FetchPlaceRequest( placeID: placeID, placeProperties: [.name, .website] ) switch await placesClient.fetchPlace(with: fetchPlaceRequest) { case .success(let place): // Handle place case .failure(let placesError): // Handle error }
Place Details 回應
Place Details 會傳回
GMSPlace
物件,包含地點的詳細資料。只有欄位清單中指定的欄位才會填入 GMSPlace
物件。
除了資料欄位之外,GMSPlace
回應包含下列成員函式:
-
isOpen
會計算地點在指定時間是否營業。 isOpenAtDate
敬上 計算地點在指定日期是否營業。
必要參數
請使用 GMSFetchPlaceRequest
物件指定必要的參數。
地點 ID
Places SDK for iOS 中使用的地點 ID 是 與 Places API、Places SDK for Android 中使用的 ID 和其他 Google API每個地點 ID 只能代表一個地點,但一個地點可以有多個地點 多個地點 ID
在某些情況下,地點可能會取得新的地點 ID。 舉例來說,如果商家搬遷到新地點,可能就會發生這種情形。
指定地點 ID 來要求地點時, 您會在回覆中收到相同位置 (如果地點仍存在 存在)。不過請注意,回應中可能包含地點 ID, 與要求中的編號不同
欄位清單
要求 Place Details 時,您必須指定要用於
傳回地點的 GMSPlace
物件,做為欄位遮罩。如何定義欄位遮罩
傳送值的陣列
GMSPlaceProperty
至 GMSFetchPlaceRequest
物件
欄位遮蓋是不錯的設計做法,確保您不會要求不必要的資料。
有助於避免不必要的處理時間和帳單費用。
指定下列一或多個欄位:
下列欄位會觸發 Place Details (ID Only) SKU:
GMSPlacePropertyPlaceID
,GMSPlacePropertyName
,GMSPlacePropertyPhotos
下列欄位會觸發 Place Details (Location Only) SKU:
GMSPlacePropertyAddressComponents
,GMSPlacePropertyFormattedAddress
,GMSPlacePropertyCoordinate
,GMSPlacePropertyPlusCode
,GMSPlacePropertyTypes
,GMSPlacePropertyViewport
下列欄位會觸發 Place Details (基本) SKU:
GMSPlacePropertyBusinessStatus
,GMSPlacePropertyIconBackgroundColor
,GMSPlacePropertyIconImageURL
,GMSPlacePropertyUTCOffsetMinutes
,GMSPlacePropertyWheelchairAccessibleEntrance
下列欄位會觸發 Place Details (進階) SKU:
GMSPlacePropertyCurrentOpeningHours
,GMSPlacePropertySecondaryOpeningHours
,GMSPlacePropertyPhoneNumber
,GMSPlacePropertyPriceLevel
,GMSPlacePropertyRating
,GMSPlacePropertyOpeningHours
,GMSPlacePropertyUserRatingsTotal
,GMSPlacePropertyWebsite
下列欄位會觸發 Place Details (Preferred) SKU:
GMSPlacePropertyCurbsidePickup
,GMSPlacePropertyDelivery
,GMSPlacePropertyDineIn
,GMSPlacePropertyEditorialSummary
,GMSPlacePropertyReservable
,GMSPlacePropertyReviews
,GMSPlacePropertyServesBeer
,GMSPlacePropertyServesBreakfast
,GMSPlacePropertyServesBrunch
,GMSPlacePropertyServesDinner
,GMSPlacePropertyServesLunch
,GMSPlacePropertyServesVegetarianFood
,GMSPlacePropertyServesWine
,GMSPlacePropertyTakeout
。
以下範例傳送
欄位值
,指出要求傳回的 GMSPlace
物件包含
name
和 placeID
欄位:
Swift
// Specify the place data types to return. let fields: [GMSPlaceProperty] = [.placeID, .name]
Objective-C
// Specify the place data types to return. NSArray<GMSPlaceProperty *> *fields = @[GMSPlacePropertyPlaceID, GMSPlacePropertyName];
GooglePlacesSwift
// Specify the place data types to return. let fields: [PlaceProperty] = [.placeID, .displayName]
選用參數
請使用 GMSFetchPlaceRequest
物件指定選用參數。
regionCode
用於設定回應格式的區碼,以 也就是雙字元 CLDR 代碼值。這個參數可能會造成偏誤 相關的更多內容沒有預設值。
如果回覆地址欄位的國家/地區名稱與 區碼,則地址中略過國家/地區代碼。
大部分 CLDR 代碼與 ISO 3166-1 代碼相同 有一些值得注意的例外情況舉例來說,英國的 ccTLD 是 「uk」(.co.uk),但 ISO 3166-1 代碼卻是「gb」(技術上來說 「大不列顛暨北愛爾蘭聯合王國」)。 這個參數會根據適用法律影響結果。
sessionToken
工作階段符記是使用者產生的字串,可追蹤自動完成功能 (新) 呼叫做為「工作階段」。自動完成 (新版) 會使用工作階段符記 將使用者自動完成搜尋的查詢和地點選擇階段歸入不同的工作階段 做為帳單用途工作階段符記會傳送至 Place Details (新) 呼叫。若需更多資訊,請參閲 工作階段符記。
在應用程式中顯示作者資訊
應用程式顯示
GMSPlacesClient
、
(例如相片和評論),應用程式也必須顯示必要的作者資訊。
例如 GMSPlacesClient
物件的 reviews
屬性
包含一個最多五個的陣列
GMSPlaceReview
敬上
如需儲存大量結構化物件
建議使用 Cloud Bigtable每個 GMSPlaceReview
物件都可以包含作者資訊以及作者作者資訊。
如果您在應用程式中顯示評論,則必須一併顯示作者資訊或作者。
出處。
詳情請參閱 作者資訊。