Yakındaki Arama (Yeni) isteği, çember olarak belirtilen arama yapılacak bölgeyi girdi olarak alır. Bu bölge, dairenin merkez noktasının enlem ve boylam koordinatları ve metre cinsinden yarıçapı ile tanımlanır. İstek, belirtilen arama alanındaki her biri bir GMSPlace
nesnesiyle temsil edilen eşleşen yerlerin listesini döndürür.
Varsayılan olarak yanıt, arama alanındaki her türden yeri içerir. İsteğe bağlı olarak, yanıta açıkça dahil edilecek veya yanıttan hariç tutulacak yer türlerinin listesini belirterek yanıtı filtreleyebilirsiniz. Örneğin, yanıta yalnızca "restoran", "pastane" ve "kafe" türündeki yerleri dahil etmeyi veya "okul" türündeki tüm yerleri hariç tutmayı belirtebilirsiniz.
Yakındaki Arama (Yeni) istekleri
Yanıtı işlemek için GMSPlacesClient searchNearbyWithRequest:
yöntemini çağırıp istek parametrelerini tanımlayan bir GMSPlaceSearchNearbyRequest
nesnesini ve GMSPlaceSearchNearbyResultCallback
türünde bir geri çağırma yöntemini ileterek Yakındakilerle Arama isteği oluşturun.
GMSPlaceSearchNearbyRequest
nesnesi, istek için tüm gerekli ve isteğe bağlı parametreleri belirtir. Gerekli parametreler şunlardır:
GMSPlace
nesnesinde döndürülecek alanların listesi.GMSPlaceProperty
tarafından tanımlandığı şekilde alan maskesi olarak da adlandırılır. Alan listesinde en az bir alan belirtmezseniz veya alan listesini çıkarırsanız çağrı bir hata döndürür.- Arama alanını tanımlayan çember anlamına gelen konum kısıtlaması.
Bu örnek yakındaki arama isteği, yanıt GMSPlace
nesnelerinin arama sonuçlarındaki her bir GMSPlace
nesnesi için yer adını (GMSPlacePropertyName
) ve yer koordinatlarını (GMSPlacePropertyCoordinate
) içerdiğini belirtir. Ayrıca, yanıtı yalnızca "restoran" ve "kafe" türündeki yerleri döndürecek şekilde filtreler.
Swift
// Array to hold the places in the response var placeResults: [GMSPlace] = [] // Define the search area as a 500 meter diameter circle in San Francisco, CA. let circularLocationRestriction = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(37.7937, -122.3965), 500) // Specify the fields to return in the GMSPlace object for each place in the response. let placeProperties = [GMSPlaceProperty.name, GMSPlaceProperty.coordinate].map {$0.rawValue} // Create the GMSPlaceSearchNearbyRequest, specifying the search area and GMSPlace fields to return. var request = GMSPlaceSearchNearbyRequest(locationRestriction: circularLocationRestriction, placeProperties: placeProperties) let includedTypes = ["restaurant", "cafe"] request.includedTypes = includedTypes let callback: GMSPlaceSearchNearbyResultCallback = { [weak self] results, error in guard let self, error == nil else { if let error { print(error.localizedDescription) } return } guard let results = results as? [GMSPlace] else { return } placeResults = results } GMSPlacesClient.shared().searchNearby(with: request, callback: callback)
Objective-C
// Array to hold the places in the response _placeResults = [NSArray array]; // Define the search area as a 500 meter diameter circle in San Francisco, CA. id<GMSPlaceLocationRestriction> circularLocation = GMSPlaceCircularLocationOption(CLLocationCoordinate2DMake(37.7937, -122.3965), 500); // Create the GMSPlaceSearchNearbyRequest, specifying the search area and GMSPlace fields to return. GMSPlaceSearchNearbyRequest *request = [[GMSPlaceSearchNearbyRequest alloc] initWithLocationRestriction:circularLocation placeProperties:@[ GMSPlacePropertyName, GMSPlacePropertyCoordinate ]]; // Set the place types to filter on. NSArray<NSString *> *includedTypes = @[ @"restaurant", @"cafe" ]; request.includedTypes = [[NSMutableArray alloc] initWithArray:includedTypes]; [_placesClient searchNearbyWithRequest:request callback:^(NSArray<GMSPlace *> *_Nullable places, NSError *_Nullable error) { if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } else { // Get list of places. _placeResults = places; } } ];
GooglePlacesSwift
let restriction = CircularCoordinateRegion(center: CLLocationCoordinate2DMake(37.7937, -122.3965), radius: 500) let searchNearbyRequest = SearchNearbyRequest( locationRestriction: restriction, placeProperties: [ .name, .coordinate], includedTypes: [ .restaurant, .cafe ], ) switch await placesClient.searchNearby(with: searchNearbyRequest) { case .success(let places): // Handle places case .failure(let placesError): // Handle error }
Yakındaki Arama yanıtları
Nearby Search API, eşleşen yer başına birGMSPlace
nesnesiyle GMSPlace
nesneleri biçiminde bir eşleşme dizisi döndürür.
Yanıttaki GMSPlace
nesnesi, veri alanlarıyla birlikte aşağıdaki üye işlevlerini içerir:
-
isOpen
, bir yerin belirtilen saatte açık olup olmadığını hesaplar. isOpenAtDate
, bir yerin belirli bir tarihte açık olup olmadığını hesaplar.
Gerekli parametreler
Arama için gerekli parametreleri belirtmek amacıyla GMSPlaceSearchNearbyRequest
nesnesini kullanın.
-
Alan listesi
Yer ayrıntılarını istediğinizde, bu yerin
GMSPlace
nesnesinde döndürülecek verileri alan maskesi olarak belirtmeniz gerekir. Alan maskesini tanımlamak içinGMSPlaceProperty
öğesindenGMSPlaceSearchNearbyRequest
nesnesine bir değer dizisi iletin. Alan maskeleme, gereksiz veri isteğinde bulunmamanızı sağlayan iyi bir tasarım uygulamasıdır. Böylece gereksiz işleme süresi ve faturalandırma ücretlerinin önüne geçilir.Aşağıdaki alanlardan birini veya daha fazlasını belirtin:
Aşağıdaki alanlar Yakındaki Arama (Temel) SKU'sunu tetikler:
GMSPlacePropertyAddressComponents
,GMSPlacePropertyBusinessStatus
,GMSPlacePropertyCoordinate
,GMSPlacePropertyFormattedAddress
,GMSPlacePropertyName
,GMSPlacePropertyIconBackgroundColor
,GMSPlacePropertyIconImageURL
,GMSPlacePropertyPhotos
,GMSPlacePropertyPlaceID
,GMSPlacePropertyPlusCode
,GMSPlacePropertyTypes
,GMSPlacePropertyUTCOffsetMinutes
,GMSPlacePropertyViewport
,GMSPlacePropertyWheelchairAccessibleEntrance
Aşağıdaki alanlar Yakındaki Arama (Gelişmiş) SKU'sunu tetikler:
GMSPlacePropertyCurrentOpeningHours
,GMSPlacePropertySecondaryOpeningHours
,GMSPlacePropertyPhoneNumber
,GMSPlacePropertyPriceLevel
,GMSPlacePropertyRating
,GMSPlacePropertyOpeningHours
,GMSPlacePropertyUserRatingsTotal
,GMSPlacePropertyWebsite
Aşağıdaki alanlar Yakındaki Arama (Tercih Edilen) SKU'sunu tetikler:
GMSPlacePropertyCurbsidePickup
,GMSPlacePropertyDelivery
,GMSPlacePropertyDineIn
,GMSPlacePropertyEditorialSummary
,GMSPlacePropertyReservable
,GMSPlacePropertyReviews
,GMSPlacePropertyServesBeer
,GMSPlacePropertyServesBreakfast
,GMSPlacePropertyServesBrunch
,GMSPlacePropertyServesDinner
,GMSPlacePropertyServesLunch
,GMSPlacePropertyServesVegetarianFood
,GMSPlacePropertyServesWine
,GMSPlacePropertyTakeout
Aşağıdaki örnekte, bir istek tarafından döndürülen
GMSPlace
nesnesininname
veplaceID
alanlarını içerdiğini belirtmek üzere iki alan değerinden oluşan bir liste aktarılır: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]
-
locationRestriction
Merkez noktası ve yarıçapla metre cinsinden tanımlanan, daire olarak belirtilmiş aranacak bölgeyi tanımlayan bir
GMSPlaceLocationRestriction
nesnesi. Yarıçap 0,0 ile 50000,0 (her ikisi de dahil) arasında olmalıdır. Varsayılan yarıçap 0,0'dır. Bunu isteğinizde 0,0'dan büyük bir değere ayarlamanız gerekir.
İsteğe bağlı parametreler
Aramayla ilgili isteğe bağlı parametreleri belirtmek için GMSPlaceSearchNearbyRequest
nesnesini kullanın.
-
includes/excludedTypes, includePrimaryTypes/excludedPrimaryTypes
Arama sonuçlarını filtrelemek için kullanılan Tablo A türlerinden bir tür listesi belirtebilmenizi sağlar. Her tür kısıtlama kategorisinde en fazla 50 tür belirtilebilir.
Bir yerin yalnızca kendisiyle ilişkili Tablo A türlerindeki tek bir birincil türü olabilir. Örneğin, birincil tür
"mexican_restaurant"
veya"steak_house"
olabilir. Sonuçları bir yerin birincil türüne göre filtrelemek içinincludedPrimaryTypes
veexcludedPrimaryTypes
öğelerini kullanın.Bir yerin kendisiyle ilişkili Tablo A türlerinden birden çok tür değeri de olabilir. Örneğin bir restoran şu türlere sahip olabilir:
"seafood_restaurant"
,"restaurant"
,"food"
,"point_of_interest"
,"establishment"
. Bir yerle ilişkili türler listesindeki sonuçları filtrelemek içinincludedTypes
veexcludedTypes
kullanın.Bir arama birden fazla tür kısıtlamasıyla belirtilirse yalnızca tüm kısıtlamaları karşılayan yerler döndürülür. Örneğin,
{"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]}
değerini belirtirseniz döndürülen yerler"restaurant"
ile ilgili hizmetler sunar ancak esasen"steak_house"
olarak çalışmaz.includedTypes
A Tablosu'nda aranacak yer türlerinin listesi. Bu parametre atlanırsa, her türden yer döndürülür.
excludedTypes
Aramadan hariç tutulacak yer türlerinin listesi (A Tablosu'ndaki).
İstekte hem
includedTypes
("school"
gibi) hem deexcludedTypes
("primary_school"
gibi) belirtirseniz yanıt,"school"
olarak sınıflandırılan ancak"primary_school"
olarak kategorize edilmeyen yerleri içerir. Yanıt,includedTypes
öğelerinden en az biriyle veexcludedTypes
öğelerinden hiçbiri ile eşleşen yerleri içerir.Hem
includedTypes
hem deexcludedTypes
içinde görünen bir tür gibi çakışan türler varsaINVALID_REQUEST
hatası döndürülür.includedPrimaryTypes
A Tablosu'ndaki bir aramaya dahil edilecek birincil yer türlerinin listesi.
excludedPrimaryTypes
Aramadan hariç tutulacak A Tablosu'ndaki birincil yer türlerinin listesi.
Hem
includedPrimaryTypes
hem deexcludedPrimaryTypes
içinde görünen bir tür gibi çakışan birincil türler varsaINVALID_ARGUMENT
hatası döndürülür. -
maxResultCount
Döndürülecek maksimum yer sonucu sayısını belirtir. 1 ile 20 (varsayılan) arasında olmalıdır.
-
rankPreference
Kullanılacak sıralama türüdür. Bu parametre atlanırsa sonuçlar popülerliğe göre sıralanır. Aşağıdakilerden biri olabilir:
.popularity
(varsayılan) Sonuçları popülerliklerine göre sıralar..distance
Sonuçları, belirtilen konumdan uzaklığına göre artan düzende sıralar.
-
regionCode
Yanıtı biçimlendirmek için kullanılan, iki karakterli CLDR kodu değeri olarak belirtilen bölge kodu. Varsayılan değer yoktur.
Yanıttaki
formattedAddress
alanının ülke adıregionCode
ile eşleşirse ülke koduformattedAddress
öğesinden çıkarılır. Bu parametrenin, ülke adını her zaman içerenadrFormatAddress
veya hiçbir zaman içermeyenshortFormattedAddress
üzerinde etkisi yoktur.Çoğu CLDR kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"'dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallık'ı" için kullanılır). Parametre, geçerli yasalara göre sonuçları etkileyebilir.
İlişkilendirmeleri uygulamanızda gösterin
Uygulamanız, GMSPlacesClient
'ten alınan bilgiler (ör. fotoğraflar ve yorumlar) görüntülediğinde, gerekli atıfları da görüntülemelidir.
Örneğin, GMSPlacesClient
nesnesinin reviews
özelliği, en fazla beş GMSPlaceReview
nesneden oluşan bir dizi içerir. Her GMSPlaceReview
nesnesi, atıflar ve yazar ilişkilendirmeleri içerebilir.
Yorumu, uygulamanızda gösterirseniz herhangi bir atıf veya yazar ilişkilendirmesini de göstermeniz gerekir.
Daha fazla bilgi için ilişkilendirmeler ile ilgili dokümanlara bakın.