Giriş
Places API, bir metin dizesi kullanarak veya yakınlığa göre çeşitli yer türleri için arama yapmanıza ve bilgi almanıza olanak tanır. Places API (Eski), Places API'nin (Yeni) eski sürümüdür.
Aşağıdaki tabloda her iki API'nin de ilgili sürümleri listelenmiştir. İkisi arasındaki temel farkları anlamak ve Places API'ye (Yeni) geçiş yapmak için bu kılavuzu kullanın.
| Places API (Eski) | Places API (Yeni) | Notlar |
|---|---|---|
| Find Place (Eski) | Text Search (New) | Find Place (Eski) özelliğinin yeni bir sürümü yoktur. Text Search (New) bu hizmetin yerini almıştır. |
| Yakında Arama (Eski) | Yakında Arama (Yeni) | Nearby Search (New), metin girişini desteklemediğinden metin sorgusu içeren eski API'yi kullanan tüm isteklerde Text Search (New) kullanılmalıdır. |
| Text Search (Legacy) | Text Search (New) | |
| Yer Ayrıntıları (Eski) | Place Details (New) | |
| Place Photos (Eski) | Place Photos (New) | |
| Yer Adı Otomatik Tamamlama (Eski) | Autocomplete (New) | |
| Sorgu Otomatik Tamamlama (Eski) | Autocomplete (New) | Otomatik tamamlama (yeni) özelliğine eklenen özellikler. |
Yeni API'lere geçiş yapma
Yeni API'lere geçiş yapmak için aşağıdaki geçiş rehberlerini inceleyin:
- Yakında Arama'ya (Yeni) geçiş yapma
- Text Search'e (New) geçiş yapma
- Yer Ayrıntıları'na (Yeni) geçiş yapma
- Place Photos'a (Yeni) geçiş yapma
- Otomatik Tamamlama'ya (Yeni) Geçiş Yapın
Places API'ye (Yeni) eklenen önemli özellikler
Bu bölümde, Places API'ye (yeni) eklenen temel özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulanır.
Places API (Yeni), Google Cloud'daki hizmet altyapısında uygulanır. Bu uygulama, OAuth gibi gelişmiş güvenlik seçenekleriyle daha güvenli ve güvenilir bir platform sunar. Bu standart API tasarımı, API'ler arasında tutarlılık sağlayarak Places API (New) ile geliştirme verimliliğini artırır.
Artırılmış performans
Places API (New), daha iyi performans sunar. Bu nedenle, mevcut Places API'yi kullanan uygulamaları değiştirmeye değer.
Basitleştirilmiş fiyatlandırma
Places API (Yeni) ile fiyatlandırma basitleştirildi. Böylece yalnızca kullandığınız veriler için ödeme yaparsınız. Basitleştirilmiş fiyatlandırma, alan maskesi kullanılarak uygulanır.
Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) ile yanıtta döndürülecek alanların listesini kontrol etmek için alan maskesini kullanırsınız. Bu durumda, yalnızca istenen veriler için faturalandırılırsınız. Alan maskeleme kullanmak, gereksiz veri istememenizi sağlayan iyi bir tasarım uygulamasıdır. Bu sayede gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınabilirsiniz.
Bir yerle ilgili tutarlı yanıt verileri
Eski API'lerde Yer Ayrıntıları (Legacy), Yakında Arama (Legacy) ve Text Search (Legacy) API'leri bir yer için farklı yanıt verileri döndürüyordu. Places API (New), yanıtı standartlaştırır. Böylece bu API'lerin tümü bir yer için aynı verileri döndürür.
Genişletilmiş yer türleri
API yanıtı artık bir yerin birincil türünü içerebilir. Her yerin, Tablo A'da listelendiği gibi, yerin birincil türü olarak belirtilen tek bir tür değeri olabilir.
Yeni API'de birkaç yeni tür de bulunur. Bu yeni türleri ve mevcut türleri, Yakında Arama (Yeni) ve Metin Arama (Yeni) ile yapılan aramalarda kullanabilirsiniz. Yeni türlerin tümü Tablo A'ya dahil edilmiştir.
Dinamik yer verileri
Places API (Yeni), elektrikli araç şarj istasyonunun müsaitlik durumu veya bir benzin istasyonunun en güncel yakıt fiyatları gibi dinamik yanıt verilerini destekler. Dinamik kullanıcı deneyimleri oluşturmak için bu yanıt alanlarını kullanın.