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 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) | Metin Arama (Yeni) | Yeri Bul (Eski) özelliğinin yeni bir sürümü yoktur. Yerini Metin Arama (Yeni) aldı. |
| Yakında Arama (Eski) | Yakında Arama (Yeni) | Metin sorgusu içeren eski API'yi kullanan tüm istekler, Metin Arama (Yeni)'yı kullanmalıdır. Çünkü Yakınlardaki Arama (Yeni), metin girişini desteklemez. |
| Metin Arama (Eski) | Text Search (New) | |
| Yer Ayrıntıları (Eski) | Yer Ayrıntıları (Yeni) | |
| Yer Fotoğrafları (Eski) | Yer Fotoğrafları (Yeni) | |
| Yer Adı Otomatik Tamamlama (Eski) | Autocomplete (New) | |
| Sorgu Otomatik Tamamlama (Eski) | Autocomplete (New) | Otomatik tamamlama (yeni) özelliğine eklenen işlevler. |
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
- Yer Fotoğrafları'na (Yeni) geçiş yapma
- Otomatik Tamamlama'ya (Yeni) geçiş yapma
Places API'ye (Yeni) eklenen temel özellikler
Bu bölümde, Places API (New) sürümüne 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ı, Places API (Yeni) ile geliştirme verimliliğini artıran API'ler arasında tutarlılık sağlar.
Artırılmış performans
Places API (Yeni), mevcut Places API'yi kullanan uygulamaların değiştirilmesini sağlayacak şekilde performansı artırır.
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, field mask 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. Gereksiz veri istemediğinizden emin olmak için alan maskeleme kullanmak iyi bir tasarım uygulamasıdır. Bu sayede gereksiz işlem süresi ve faturalandırma ücretlerinden kaçınabilirsiniz.
Bir yerle ilgili tutarlı yanıt verileri
Eski API'lerde Yer Ayrıntıları (Eski), Yakında Arama (Eski) ve Text Search (Eski) 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 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, Nearby Search (Yeni) ve Text Search (Yeni) ile yapılan aramalarda kullanabilirsiniz. Yeni türlerin tümü A Tablosu'nda yer alır.
Dinamik yer verileri
Places API (Yeni), elektrikli araç şarj istasyonunun kullanılabilirliği veya benzin istasyonundaki 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.