Bu kılavuzda, eski Places Hizmeti ile yeni Place sınıfı arasındaki temel farklılıklar vurgulanmıştı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.
Taşıma için faturalandırmayla ilgili en iyi uygulamalar
Bu kılavuz, API kullanımınız ikinci katman fiyatlandırmasına geçmeye yetecek 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ıyorsunuz. Geçiş yaptığınız ay boyunca maliyetlerin artmasını önlemek için üretimde yeni API'lere mümkün olduğunca ayın başına yakın bir tarihte geçmenizi öneririz. Bu sayede, taşıma ayı boyunca en uygun aylık fiyatlandırma katmanlarına ulaşabilirsiniz. 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 öncelikle Google Cloud projenizde Rehber API'sini (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 ile Place arasındaki temel farklılıklardan bazıları listelenmiştir:
PlacesService (Eski) |
Place (Yeni) |
|---|---|
Yöntemler, results 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. |
Zorunlu durum kontrolü yoktur, standart hata işleme kullanılabilir. |
| Yer veri alanları, küçük harf ve alt çizgi kullanılarak biçimlendirilir. | Yer veri alanları, büyük/küçük harf kullanımıyla biçimlendirilir. |
| Sabit bir yer türü ve yer verisi 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 Hizmeti 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 Hizmeti'nin özelliklerinin Place sınıfının özellikleriyle nasıl eşleştiği gösterilmektedir:
Yerler kitaplığını yükleme
Uygulamanızın Places kitaplığını nasıl yükleyeceği, kullanılan önyükleme yükleyiciye bağlıdır. Uygulamanız dinamik kitaplık içe aktarma özelliğini kullanıyorsa importLibrary() işlevini çağırmak için await operatörünü kullanarak gerekli kitaplıkları çalışma zamanında yükleyebilirsiniz. Aşağıda bu işlem gösterilmektedir:
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 kılavuzlar yer almaktadır: