Taşımaya genel bakış

Bu kılavuzda, eski Yerler hizmeti ile yeni Yer 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. Yerler'den 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 öğrenin.

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 başlıklı makaleyi inceleyin.

Genel değişiklikler

Aşağıdaki tabloda, PlacesService ile Place arasındaki temel farklılıklardan bazıları listelenmiştir:

PlacesService (Eski) Place (Yeni)
Yöntemler, sonuçlar nesnesini ve google.maps.places.PlacesServiceStatus yanıtını işlemek için 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. Zorunlu durum kontrolü yoktur, standart hata işleme kullanılabilir.
Yer veri alanları, küçük harf ve tire kullanılarak biçimlendirilir. Yer veri alanları, büyük/küçük harf kullanmadan biçimlendirilir.
Sabit bir yer türü ve yer veri alanı kümesiyle sınırlıdır. Düzenli olarak güncellenen yer türleri ve yer veri alanları ile ilgili daha geniş 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 Promise'ler 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 gösterir ve yer veri alanları ile yer türleri için birçok yeni değer içerir.

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

Yerler Hizmeti (Eski) Yer Sınıfı (Yeni)
Yer Veri 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 ---

Yerler kitaplığını yükleme

Uygulamanızın Places kitaplığını nasıl yüklediği, kullanılan önyükleme yükleyiciye bağlıdır. Uygulamanız dinamik kitaplık içe aktarma özelliğini kullanıyorsa burada gösterildiği gibi importLibrary()'ı çağırmak için await operatörünü kullanarak 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ı Places API'nin en yeni sürümüne taşımanıza yardımcı olacak aşağıdaki rehberler yer almaktadır: