Taşımaya genel bakış

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Bu kılavuzda, eski Places Service ile yeni Place sınıfı arasındaki temel farklar vurgulanmaktadır. Place sınıfına geçmek, daha iyi performans ve yeni bir fiyatlandırma modeli gibi önemli avantajlar sunar. Places'tan en iyi şekilde yararlanmak ve uygulamalarınızın güncel olduğundan emin olmak için bu kılavuzda ayrıntılı olarak açıklanan değişiklikleri inceleyin.

Taşıma işlemi için faturalandırmayla ilgili en iyi uygulamalar

Bu kılavuz, API kullanımınız ikinci kademe fiyatlandırmaya geçecek kadar yüksekse geçerlidir. Bir API'nin daha yeni bir sürümüne geçiş yaparken farklı bir SKU için de faturalandırılırsınız. Geçiş yaptığınız ay boyunca maliyetlerin artmasını önlemek için yeni API'lere ayın başına mümkün olduğunca yakın bir zamanda geçmenizi öneririz. Bu sayede, geçiş ayında en uygun maliyetli aylık fiyatlandırma katmanlarına ulaşırsınız. Fiyatlandırma katmanları hakkında bilgi edinmek için fiyatlandırma sayfasını ve fiyatlandırmayla ilgili SSS bölümünü inceleyin.

Places API'yi etkinleştirme

Place sınıfı, Places API hizmetini kullanır. Yeni Place sınıfının özelliklerini kullanmak için önce Google Cloud projenizde Places API'yi (yeni) etkinleştirmeniz gerekir. Daha fazla bilgi için Başlayın bölümüne bakın.

Genel değişiklikler

Aşağıdaki tabloda PlacesService ve Place arasındaki temel farklardan bazıları listelenmiştir:

PlacesService (Eski) Place (Yeni)
Yöntemler, sonuç nesnesini ve google.maps.places.PlacesServiceStatus yanıtını işlemek için bir geri çağırma işlevinin kullanılmasını gerektirir. Promise'leri kullanır ve eşzamansız olarak çalışır.
Yöntemler için PlacesServiceStatus kontrolü gerekir. Durum kontrolü gerekmez, standart hata işleme kullanılabilir.
Yer verisi alanları, alt çizgili yazım kullanılarak biçimlendirilir. Yer verileri alanları, camel case kullanılarak biçimlendirilir.
Sabit bir yer türleri ve yer verisi alanları kümesiyle sınırlıdır. Düzenli olarak güncellenen yer türleri ve yer verisi alanları için daha geniş bir seçim olanağı sunar.

API'ye özgü değişiklikler

Place sınıfı, Places kitaplığını kullanmak için bir API sağlar ve Promises gibi modern kullanım kalıplarını destekler. Place sınıfı, eski Places Service ile aynı yer veri alanlarını ve yer türlerini sunar. Ayrıca yer veri alanları ve yer türleri için birçok yeni değer içerir.

Bu tabloda, Places Service özelliklerinin Place sınıfı özellikleriyle nasıl eşlendiği gösterilmektedir:

Places Service (Eski) Yer Sınıfı (Yeni)
Yer Verileri Alanları Yer Sınıfı Veri Alanları
Yer Türleri Yer Türleri
PlacesService.findPlaceFromQuery() Place.searchByText()
PlacesService.findPlaceFromPhoneNumber() Place.searchByText()
PlacesService.textSearch() Place.searchByText()
PlacesService.nearbySearch() Place.searchNearby()
PlacesService.getDetails() Place.fetchFields()
Places.AutocompletionRequest Places.AutocompleteRequest
Places.AutocompletePrediction Places.PlacePrediction
Autocomplete sınıfı PlaceAutocompleteElement sınıfı
SearchBox sınıfı ---

Places kitaplığını yükleme

Uygulamanızın Places kitaplığını nasıl yüklediği, hangi önyükleyicinin kullanıldığına bağlıdır. Uygulamanız dinamik kitaplık içe aktarma özelliğini kullanıyorsa gerekli kitaplıkları çalışma zamanında yüklemek için await operatörünü kullanarak importLibrary() işlevini çağırabilirsiniz. Örnek:

const { Place } = await google.maps.importLibrary("places");

Uygulamanız doğrudan komut dosyası yükleme etiketini kullanıyorsa yükleyici komut dosyasında places kitaplığını isteyin:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>

Maps JavaScript API'yi yükleme hakkında daha fazla bilgi edinin.

Bu bölümde, uygulamalarınızı Places API'nin en yeni sürümünü kullanacak şekilde taşımanıza yardımcı olacak aşağıdaki kılavuzlar yer alır: