Yerler SDK'sı for Android, Android uygulamalarının Yer Adı Otomatik Tamamlama, Yer Ayrıntıları, Yakında Arama, Metin Arama ve Yer Fotoğrafları aracılığıyla Google'ın yer ve işletme bilgileri veritabanına erişmesine olanak tanır. Android için Yerler SDK'sı (Yeni), mevcut sürümdür ve Places API'ye (Yeni) bağlıdır.
Android için Yerler SDK'sı: Temel bilgiler
- Ürün: Android için Yerler SDK'sı
- Diğer adları: Android için Yerler SDK'sı (Yeni)
- Kategori: Yerler
- Platform: Android
- Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: Android için Yerler SDK'sına genel bakış
Android için Yerler SDK'sı: Ne zaman kullanılır?
Android için Yerler SDK'sını şu durumlarda kullanın:
- Yer ayrıntıları, fotoğraflar, Yakında Arama veya Metin Arama sonuçlarını yerel bir Android uygulamasında kullanmanız gerekiyorsa
- Kullanıcılar bir Android uygulamasına yazarken yer tahminleri döndüren hazır bir otomatik tamamlama widget'ına veya Places UI Kit bileşenlerine ihtiyacınız vardır.
- Kullanıcının cihazının yakınındaki işletmelere ve önemli yerlere göre konuma duyarlı Android özellikleri oluşturmanız gerekiyor.
Android için Yerler SDK'sını kullanmamanız gereken durumlar:
- Places'ı Android uygulaması yerine HTTP üzerinden bir sunucudan veya arka uçtan çağırmanız gerekir. Bunun yerine Places API'yi (yeni) kullanın.
- Yerel bir iOS uygulaması geliştiriyorsunuz. Bunun yerine iOS için Yerler SDK'sı'nı kullanın.
- Tarayıcıda bir web sayfası oluşturuyorsunuz. Bunun yerine Maps JavaScript API'yi kullanın.
Android için Yerler SDK'sı: kurulum
- Etkinleştirilecek hizmet:
places.googleapis.com - Kimlik doğrulama: API anahtarı
- Kullanım ilişkilendirmesi: Kullanım ilişkilendirme kimliği göndermek için SDK'yı başlatırken
Places.addInternalUsageAttributionId(String)yöntemini çağırın. Bu özelliği devre dışı bırakmak için çağrıyı silin veya boş bir dize iletin. - Başlayın: Android için Yerler SDK'sını ayarlama
- Referans: Android için Yerler SDK'sı referansı
- Fiyatlandırma: Android için Yerler SDK'sı kullanımı ve faturalandırması
- Politikalar: Android için Yerler SDK'sı politikaları
- Sürüm notları: Android için Yerler SDK'sı sürüm notları
Android için resmi Yerler SDK'sı paketleri:
- maven:
com.google.android.libraries.places:places
Android için Yerler SDK'sı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Android için Haritalar SDK'sı
Android için Yerler SDK'sı: Sık yapılan yanlışlar
- Sorun: Alan listesi (alan maskesi) olmayan veya boş bir alan listesi içeren Yakında Arama istekleri hata döndürür. Düzeltme:
SearchNearbyRequestalan listesinde en az birPlace.Fieldiletin. /maps/documentation/places/android-sdk/nearby-search adresini inceleyin. - Sorun: API anahtarında Places API (Yeni) yoksa veya uygulama SDK 5.x ve önceki sürümlerde
Places.initialize()yöntemini çağırıyorsa Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Otomatik Tamamlama (Yeni) başarısız olur. 6.0.2 sürümündePlaces.initialize()kaldırıldı. Bu nedenle, bu yöntemi çağıran kod, yükseltme işleminden sonra derlenmez. Düzeltme: Places API'yi (yeni) etkinleştirin, API anahtarının izin verilen API'lerine ekleyin vePlaces.initializeWithNewPlacesApiEnabled()ile ilk kullanıma hazırlayın. /maps/documentation/places/android-sdk/legacy/migrate-overview adresine göz atın. - Sorun: Alan listesi
PHOTO_METADATASdeğerini atladığındafetchPlace()tarafından döndürülenPlace,PhotoMetadatadeğerine sahip olmaz (bu nedenle çözümlenecek bir şey yoktur). Düzeltme: Alan listesinePlace.Field.PHOTO_METADATASdeğerini ekleyin.fetchResolvedPhotoUri()desteği sonlandırıldığından, fotoğrafları görüntülemek için Places UI Kit Yer Ayrıntıları bileşenini kullanın. /maps/documentation/places/android-sdk/place-photos sayfasına bakın. - Sorun: Döndürülen üçüncü taraf ve yazar atıfları olmadan yer ayrıntılarını, fotoğrafları veya yorumları gösteren uygulamalar politikaları ihlal eder. Düzeltme:
Place,PhotoMetadataveReviewnesneleriyle döndürülen atıfları gösterin. /maps/documentation/places/android-sdk/policies sayfasına bakın.
Android için Yerler SDK'sı: eski ve desteği sonlandırılmış özellikler
- Android için Yerler SDK'sı (eski) / Places API (eski) özellikleri (Otomatik Tamamlama, Mevcut Yer, Yer Ayrıntıları, Yer Fotoğrafları eski): 2025-03-01 tarihinden itibaren eski. Değişiklik: Places API (Yeni) tarafından desteklenen ve
Places.initializeWithNewPlacesApiEnabled()ile başlatılan Android için Yerler SDK'sı (Yeni) özellikleri. Belirti: Ekim 2026'dan itibaren yeni Cloud projeleri Places API'yi (eski) etkinleştiremeyecek (mevcut projeler desteklenmeye devam edecek). SDK 6.0.2, yalnızca 5.x ve önceki sürümlerde bulunan eski yöntemleri kaldırdı. Geçiş rehberini inceleyin. Places.initialize(): 30 Eylül 2026'dan itibaren kullanımdan kaldırıldı. Değiştirme:Places.initializeWithNewPlacesApiEnabled(). Belirti: Yöntem, 6.0.2 sürümünde SDK'dan kaldırıldı. Bu yöntemi çağıran kod artık derlenmiyor. Geçiş rehberini inceleyin.PlacesClient.findCurrentPlace()veawaitFindCurrentPlace()(Mevcut Yer, eski): 30.09.2026'dan itibaren kullanımdan kaldırıldı. Değişiklik:PlacesClient.searchNearby()(Yakında Arama (Yeni)). Belirti: 6.0.2 sürümünde yöntemler veFindCurrentPlaceRequest/FindCurrentPlaceResponsesınıfları kaldırıldı. Geçiş rehberini inceleyin.PlacesClient.fetchPhoto()veawaitFetchPhoto(): 30.09.2026 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik: Places UI Kit Yer Ayrıntıları bileşeni (PlacesClient.fetchResolvedPhotoUri()kullanımdan kaldırıldı). Belirti: 6.0.2 sürümünde yöntemler veFetchPhotoRequest/FetchPhotoResponsesınıfları kaldırıldı. Geçiş rehberini inceleyin.- Places API (Eski) otomatik tamamlama widget'ı (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode): 30 Eylül 2026'dan itibaren kullanımdan kaldırılacak. Değişiklik: Yer Adı Otomatik Tamamlama (Yeni) widget'ı (PlaceAutocomplete) veyaPlacesClient.findAutocompletePredictions(). Belirti: Sınıflar, 6.0.2 sürümünde SDK'dan kaldırıldı. Geçiş rehberini inceleyin. - Places uyumluluk kitaplığı (
com.google.android.libraries.places:places-compat): 31.03.2022 tarihinden itibaren desteği sonlandırıldı. Değişiklik: Android için Yerler SDK'sı (com.google.android.libraries.places:places). Belirti: 2.6.0 sürümünde donduruldu; yeni özellik veya hata düzeltmesi yok. AutocompleteFragmentsınıfı: 25.09.2025 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik: Yer Adı Otomatik Tamamlama (Yeni) widget'ı (PlaceAutocomplete). Belirti: Sınıf, 5.0.0 sürümünde SDK'dan kaldırıldı (AutocompleteSupportFragmentda 6.0.2 sürümünde kaldırıldı).
Android için Yerler SDK'sı ile yapabilecekleriniz
Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.
Android için Yerler SDK'sı: Üretken Yapay Zeka
- Belirli bir Google yer tanımlayıcısı için kullanıcı yorumlarının yapay zeka destekli özetini döndürür.
- Elektrikli araç şarj istasyonu için belirtilen Google yer tanımlayıcısının çevresindeki alanın ve imkanların yapay zeka destekli yer özetini döndürür.
Android için Yerler SDK'sı: Yerler
- Sorgu dizesine göre yerlerin ve yer ayrıntılarının listesini döndürür.
- Belirli bir konumun yakınındaki yerlerin ve yer ayrıntılarının listesini döndürür.
- Bir sorgu dizesine göre yerlerle ilgili otomatik tamamlama sonuçları döndürür.
- Belirli bir yer hakkında ayrıntılı bilgi döndürür.
- Belirli bir yerin fotoğraflarını döndürme Not: Her fotoğrafın yazar atıflarını (yazarın adı, profil URI'sine bağlı) fotoğrafla birlikte gösterin. Her platformun Yerler politikaları bunu gerektirir (ör. /maps/documentation/javascript/policies#photo-attributions ve /maps/documentation/places/web-service/policies#photos-and-review).
- Yer fotoğraflarını yeniden boyutlandırma
- Belirli bir yerle ilgili puanları ve yorumları döndürme Not: Places API (Yeni) web hizmetinde Yer Ayrıntıları, X-Goog-FieldMask (ör. rating,userRatingCount,reviews) ile https://places.googleapis.com/v1/places/{placeId} adresine gönderilen bir HTTP GET isteğidir. Metin Arama, Yakında Arama ve Otomatik Tamamlama ise POST kullanır. Android'de Place.Field.RATING, USER_RATING_COUNT ve REVIEWS değerlerini PlacesClient.fetchPlace() yöntemine iletin. iOS'te GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal ve GMSPlacePropertyReviews değerlerini GMSFetchPlaceRequest'e iletin.
- Bir sorgu dizesine göre yerlerle ilgili sonuçlar döndüren bir web sayfasına veya uygulamaya otomatik tamamlama widget'ı ekleyin.
- Yer bilgileri yanıtlarına dahil edilen veri alanlarını belirtin.
- Yer bilgisi yanıtlarına dahil edilecek yer türlerini belirtin.
- Bir yerin Google Haritalar'daki yer ayrıntıları sayfasını açmak için URI'yi döndürün.
- Kullanıcının cihazının şu anda bulunduğu yerle ilgili bilgileri döndürür. Not: Eski Current Place yöntemleri, Android için Yerler SDK'sı 6.0+ ve iOS için Yerler SDK'sı 11.0+ sürümlerinden kaldırılmıştır. Cihaz koordinatlarını platform konum hizmetlerinden alın ve Yakında Arama'yı çağırın.
- Belirli bir yer için yapay zeka destekli özet döndürür.
- Belirli bir yerin çevresindeki yerleri açıklayan yapay zeka destekli bir alan özeti döndürür.
- Önceden tanımlanmış bir rota üzerinde bulunan yerler hakkında bir sorgu dizesine göre bilgi döndürür.
- Bir dizi enlem/boylam koordinatından metin araması yapılan yerlere olan mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
- Bir dizi enlem/boylam koordinatından yakındaki yerlere olan mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
- Önceden tanımlanmış bir rotanın başlangıç noktası ile sorgu dizesine göre döndürülen ve rota üzerinde bulunan yerlerin her biri arasındaki mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
- Sorgu dizesine göre döndürülen ve önceden tanımlanmış bir rota ile rota hedefi boyunca bulunan yerlerin her biri arasındaki mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürür.
Android için Yerler SDK'sı: Places UI Kit
- Yer verileri kullanıcı arayüzü öğesine CSS stili uygulama Not: CSS özel özellikleri, Maps JavaScript API Places UI Kit öğeleri için geçerlidir. Android için Yerler SDK'sı ve iOS için Yerler SDK'sı, tema ve stil özelliklerini kullanarak Place UI Kit görünümlerini programatik olarak stillendirir. AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir harita üzerinde yer verilerini göstermek için Places API web hizmetlerini bir arka uç sunucusundan çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
- Kullanıcı arayüzü öğesi özelleştirme aracıyla yer verileri kullanıcı arayüzü öğesi stilini ve yapılandırmalarını özelleştirme Not: AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir haritada yer verilerini göstermek için arka uç sunucusundan Places API web hizmetlerini çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
- Web sayfasına veya mobil uygulamaya belirli bir yerle ilgili bilgileri gösteren bir kullanıcı arayüzü öğesi ekleyin. Not: AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) harita üzerinde yer verilerini göstermek için arka uç sunucusundan Places API web hizmetlerini çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
- Bir web sayfasına, sorgu dizesine göre yerlerin listesini gösteren bir kullanıcı arayüzü öğesi ekleyin. Not: Hem web sayfalarında (Maps JavaScript API) hem de mobil uygulamalarda (Android için Yerler SDK'sı ve iOS için Yerler SDK'sı) desteklenir. AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir harita üzerinde yer verilerini göstermek için Places API web hizmetlerini bir arka uç sunucusundan çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
- Web sayfasına, belirli bir konumun yakınındaki yerlerin listesini gösteren bir kullanıcı arayüzü öğesi ekleyin. Not: Hem web sayfalarında (Maps JavaScript API) hem de mobil uygulamalarda (Android için Yerler SDK'sı ve iOS için Yerler SDK'sı) desteklenir. AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir harita üzerinde yer verilerini göstermek için Places API web hizmetlerini bir arka uç sunucusundan çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
- Bir sorgu dizesine göre Google yer tanımlayıcıları döndüren bir web sayfasına veya uygulamaya temel bir otomatik tamamlama kullanıcı arayüzü öğesi ekleyin. Not: AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir haritada yer verilerini göstermek için arka uç sunucusundan Places API web hizmetlerini çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq