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, Places API (Yeni)'nin eski sürümüdür.
Aşağıdaki tabloda her iki API'nin de ilgili sürümleri listelenmiştir. Bu ikisi arasındaki temel farkları anlamak ve Places API'ye (Yeni) geçmek için bu kılavuzu kullanın.
| Places API (eski) | Places API (Yeni) | Notlar |
|---|---|---|
| Yer Bulma (eski) | Metin Arama (Yeni) | Yer Bul'un yeni bir sürümü yoktur. Bunun yerine Metin Arama (Yeni) özelliği kullanıma sunuldu. |
| Yakında Arama (eski) | Yakında Arama (Yeni) | Eski API'yi kullanan ve metin sorgusu içeren tüm istekler, metin girişini desteklemediği için Yakınındakiler Arama (Yeni) yerine Metin Arama (Yeni)'yi kullanmalıdır. |
| Metin Arama (Eski) | Metin Arama (Yeni) | |
| Yer Ayrıntıları (eski) | Yer Ayrıntıları (Yeni) | |
| Yer Fotoğrafı (eski) | Yer Fotoğrafı (Yeni) | |
| Yer Adı Otomatik Tamamlama (Eski) | Otomatik tamamlama (Yeni) | |
| Sorgu Otomatik Tamamlama (Eski) | Otomatik tamamlama (Yeni) | Otomatik Tamamlama'ya yeni özellikler eklendi (Yeni). |
Yeni API'lere geçiş
Yeni API'lere geçiş yapmak için aşağıdaki taşıma kılavuzlarına bakın:
- Yakında Arama'ya geçiş (Yeni)
- Metin aramaya taşıma (Yeni)
- Yer Ayrıntıları'na taşıma (Yeni)
- Yer fotoğrafına taşıma (Yeni)
- Otomatik Tamamlama'ya taşıma (Yeni)
Places API'ye eklenen temel özellikler (Yeni)
Bu bölümde, Places API'ye (Yeni) eklenen önemli özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulanır.
Rehber API (Yeni), Google Cloud'daki hizmet altyapısında uygulanır. Bu uygulama, OAuth gibi gelişmiş güvenlik seçeneklerine sahip daha güvenli ve güvenilir bir platform sunar. Bu standart API tasarımı, API'ler arasında tutarlılık düzeyi sağlayarak Places API (Yeni) ile geliştirme verimliliğini artırır.
Artırılmış performans
Places API (Yeni), mevcut Places API'yi kullanan uygulamaların yerini almanın faydalı olmasını sağlayan gelişmiş bir performans sunar.
Basitleştirilmiş fiyatlandırma
Yalnızca kullandığınız veriler için ödeme yapabilmeniz amacıyla fiyatlandırma, Places API (Yeni) ile basitleştirilmiştir. Basitleştirilmiş fiyatlandırma, alan maskesi kullanılarak uygulanır.
Yer Ayrıntıları (Yeni), Yakındakiler Arama (Yeni) ve Metin Arama (Yeni) ile yanıtta döndürülecek alan 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 maskelemeyi kullanmak, gereksiz veri istemediğinizden emin olmak için iyi bir tasarım uygulamasıdır. Bu, gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınmanıza yardımcı olur.
Bir yer için tutarlı yanıt verileri
Mevcut API'lerde Yer Ayrıntıları, Yakındakiler Arama ve Metin Arama API'leri bir yer için farklı yanıt verileri döndürüyordu. Places API (Yeni), 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 yer, Tablo A'da listelendiği gibi yerin birincil türü olarak belirtilen tek bir tür değerine sahip olabilir.
Yeni API, birkaç yeni tür de içeriyor. Bu yeni türleri ve mevcut türleri, Yakındakiler Arama (Yeni) ve Metin Arama (Yeni) ile yapılan bir aramada kullanabilirsiniz. Yeni türlerin tümü Tablo A'ya dahildir.
Dinamik yer verileri
Places API (Yeni), elektrikli araç şarj istasyonunun müsaitlik durumu veya bir benzin istasyonunun en son yakıt fiyatları gibi dinamik yanıt verilerini destekler. Dinamik kullanıcı deneyimleri oluşturmak için bu yanıt alanlarını kullanın.