Places API (Eski) hızlı referansı

Places API (Eski), Ekim 2026'dan itibaren yeni Google Cloud projeleri için etkinleştirilemeyecek. Mevcut projeler tam olarak desteklenmeye devam eder. Yeni özellikler ve daha iyi performans için Places API'ye (Yeni) geçiş yapın.

Places API (Eski): Temel bilgiler

  • Ürün: Places API (Eski)
  • Diğer adları: Places API (eski web hizmeti), Places API web hizmeti (maps/api/place)
  • Kategori: Yerler
  • Platform: Web hizmeti (REST)
  • Çalıştığı yer: Sunucu (arka uç kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Eski
  • Yerine gelen: Places API (Yeni)
  • Genel bakış: Places API'ye (Eski) genel bakış

Places API (Eski): Ne zaman kullanılır?

Places API'yi (eski) şu durumlarda kullanın:

  • Places API'nin (Eski) etkin olduğu ve maps.googleapis.com/maps/api/place uç noktalarını çağıran mevcut bir projeniz var.
  • Taşıma işlemi sırasında çalışmaya devam etmek için mevcut Yer Bulma, Yakında Arama, Metin Arama, Ayrıntılar, Fotoğraflar veya Otomatik Tamamlama (Eski) çağrılarınızın olması gerekir.

Places API'yi (Eski) şu durumlarda kullanmayın:

  • Yeni bir Google Cloud projesi başlatıyorsunuz. Ekim 2026'dan itibaren Places API (Eski) yeni projeler için etkinleştirilemeyecek. Bunun yerine Places API'yi (Yeni) kullanın.
  • Yalnızca istediğiniz alanlar için ödeme yapmak istiyorsanız Yakında Arama ve Metin Arama'da yeni özelliklere, OAuth kimlik doğrulamasına veya alan maskelerine ihtiyacınız vardır. Bunun yerine Places API'yi (Yeni) kullanın.
  • Yeni kodda Find Place (Eski) veya Query Autocomplete (Eski) kullanmanız gerekir. Text Search (New) ve Autocomplete (New) bu hizmetlerin yerini alır. Bunun yerine Places API'yi (Yeni) kullanın.

Places API (Eski): Kurulum

Places API (Eski): Sık yapılan yanlışlar

  • Sorun: Place Details (Legacy) isteğinde fields parametresi atlanırsa veya hiçbir alan belirtilmezse API tüm alanları döndürür ve tüm alanlar için sizi faturalandırır. Düzeltme: Her zaman fields parametresini ayarlayın veya alan maskesiyle Yer Ayrıntıları (Yeni) hizmetine geçiş yapın. /maps/documentation/places/web-service/legacy/details adresini inceleyin.
  • Sorun: Yakında Arama (Eski) ve Metin Arama (Eski), hangi alanların döndürüleceğini belirtmeyi desteklemez. Her zaman sabit bir alan grubu (Yer Ayrıntıları alanlarının bir alt kümesi) döndürür ve Temel Veriler, İletişim Verileri ve Atmosfer Verileri SKU'larını tetiklerler. Düzeltme: Alan maskesiyle Yakında Arama (Yeni) veya Metin Arama (Yeni) özelliğine geçiş yapın ya da yalnızca ihtiyacınız olan alanları isteyip ödeme yapmak için fields parametresiyle Yer Bulma (Eski) özelliğini kullanın. /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku adresini inceleyin.
  • Sorun: photo_reference önbelleğe alınamaz ve süresi dolabilir. Bu nedenle, depolanan referanslar çalışmayı durdurur. Düzeltme: Fotoğraf isteğinde bulunmadan önce Yer Ayrıntıları, Yer Bulma, Yakında Arama veya Metin Arama yanıtından yeni bir photo_reference alın. /maps/documentation/places/web-service/legacy/photos adresini inceleyin.
  • Sorun: Places API'nin (Eski) etkinleştirilmediği bir projeden bu API'ye yapılan çağrılar, "Projeniz için etkinleştirilmemiş eski bir API'yi çağırıyorsunuz..." hata mesajıyla birlikte REQUEST_DENIED hatasını döndürür. LegacyApiNotActivatedMapError. Ekim 2026'dan itibaren Places API (Eski) yeni projeler için etkinleştirilemeyecek. Düzeltme: Yeni projeler için Places API'yi (yeni) kullanın ve mevcut uygulamaları taşıyın. Geçiş yaparken eski sayfadaki geri bildirim formu aracılığıyla eski API'nin kısa süreli etkinleştirilmesini talep edebilirsiniz. /maps/legacy#LegacyApiNotActivatedMapError sayfasına bakın.

Places API (Eski): Eski ve desteği sonlandırılmış özellikler

  • permanently_closed yanıt alanı: 26.05.2020'den beri desteği sonlandırıldı. Değiştirme: business_status alanı. Geçiş rehberini inceleyin.
  • reference yanıt alanı: 03.09.2019 tarihinden itibaren kullanımdan kaldırılmıştır. Değiştirme: place_id alanı. Geçiş rehberini inceleyin.
  • Yakında Arama (Eski) name istek parametresi: Desteği sonlandırıldı. Değişiklik: keyword parametresi. Geçiş rehberini inceleyin.