Taşımaya genel bakış

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Bu kılavuzda, eski Places Service ile yeni Place sınıfı arasındaki temel farklılıklar vurgulanmaktadır. Yer sınıfına yükseltme, daha iyi performans ve yeni bir fiyatlandırma modeli dahil olmak üzere önemli avantajlar sunar. Places'ten en iyi şekilde yararlanmak ve uygulamalarınızın güncel olmasını sağlamak için bu kılavuzda ayrıntılı olarak açıklanan değişiklikleri inceleyin.

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

Bu kılavuz, API kullanımınız ikinci katman fiyatlandırmasına geçecek kadar yüksekse geçerlidir. Bir API'nin daha yeni bir sürümüne geçiş yaptığınızda farklı bir SKU için de faturalandırılırsınız. Geçiş yaptığınız ayda maliyetlerin artmasını önlemek için mümkün olduğunca ayın başında üretimde yeni API'lere geçmenizi öneririz. Bu sayede, taşıma 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ına ve fiyatlandırma SSS'sine bakın.

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 (Yeni) sürümünü etkinleştirmeniz gerekir. Daha fazla bilgi için Başlangıç başlıklı makaleyi inceleyin.

Genel değişiklikler

Aşağıdaki tabloda, PlacesService ile 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 geri çağırma işlevinin kullanılmasını gerektirir. Promises 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 verileri alanları, snake case kullanılarak biçimlendirilir. Yer verisi alanları, camel case kullanılarak biçimlendirilir.
Yer türleri ve yer verileri alanlarından oluşan sabit bir grupla sınırlıdır. Düzenli olarak güncellenen yer türleri ve yer verisi alanları için daha kapsamlı bir seçim 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 Hizmeti ile aynı yer veri alanlarını ve yer türlerini kullanır. Ayrıca, yer veri alanları ve yer türleri için birçok yeni değer içerir.

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

Places Service (Eski) Yer Sınıfı (Yeni)
Yer Veri Alanları Sınıf Veri Alanlarını Yerleştirme
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ı ---

Yer Kitaplığı'nı yükleme

Uygulamanızın Places kitaplığını nasıl yüklediği, kullanılan bootstrap yükleyicisine bağlıdır. Uygulamanız dinamik kitaplık içe aktarma kullanıyorsa await operatörünü kullanarak importLibrary()'ü çağırarak gerekli kitaplıkları çalışma zamanında yükleyebilirsiniz.

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ı taşıyarak Places API'nin en yeni sürümünü kullanmanıza yardımcı olacak aşağıdaki rehberler yer alır: