Places API (Yeni) hızlı referansı

Places API (Yeni), işletmeler, coğrafi konumlar ve önemli yerler hakkında JSON konum verileri döndüren bir web hizmetidir. Metin Arama (Yeni), Yakında Arama (Yeni), Otomatik Tamamlama (Yeni), Yer Ayrıntıları (Yeni) ve Yer Fotoğrafları (Yeni) özelliklerini destekler.

Places API (Yeni): Temel bilgiler

  • Ürün: Places API (Yeni)
  • Diğer adları: Places API
  • Kategori: Yerler
  • Platform: Web hizmeti (REST)
  • Çalıştığı yer: Sunucu (arka uç kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: Places API'ye (yeni) genel bakış
  • Kullanılabildiği bölgeler: Dünya geneli. AEA fatura adreslerine sahip projeler, Google Haritalar Platformu AEA Hizmet Şartları'na (8 Temmuz 2025'ten itibaren geçerli) tabidir. Bu şartlar uyarınca, enlem, boylam ve yer kimlikleri dışındaki Places API içerikleri, Places UI Kit aracılığıyla sunulanlar hariç olmak üzere hiçbir haritada kullanılamaz. Yapay zeka destekli yer, yorum ve bölge özetleri yalnızca desteklenen dillerde ve bölgelerde kullanılabilir.

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

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

  • Bir sunucudan metin sorgusu (Metin Arama (Yeni)) veya bir konumun çevresinde (Yakında Arama (Yeni)) yer aramanız gerekir.
  • Autocomplete (New) aracılığıyla bir arka uçtan yazarken yer veya sorgu tahminleri almanız gerekiyorsa
  • Bir yer kimliğiniz varsa ve adres, telefon numarası, puan, yorum veya fotoğraf gibi ayrıntılara ihtiyacınız varsa.
  • Bir yer için yapay zeka destekli yer, yorum veya bölge özetlerine ihtiyacınız varsa

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

  • Yerel bir Android uygulaması geliştiriyorsunuz. Bunun yerine Android için Yerler SDK'sı'nı kullanın.
  • Yerel bir iOS uygulaması geliştiriyorsunuz. Bunun yerine iOS için Yerler SDK'sı'nı kullanın.
  • Bir tarayıcı web uygulaması geliştiriyorsunuz ve Places kitaplığının JavaScript'te yüklenmesini istiyorsunuz. Bunun yerine Maps JavaScript API'yi kullanın.

Places API (Yeni): Kurulum

Resmi Places API (Yeni) paketleri:

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • go: cloud.google.com/go/maps

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

  • Sorun: Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) için döndürülen alanların varsayılan bir listesi yoktur. Alan maskesi olmayan istekler hata döndürür. Düzeltme: fields veya $fields parametresi ya da X-Goog-FieldMask başlığıyla bir yanıt alanı maskesi iletin. /maps/documentation/places/web-service/choose-fields adresini inceleyin.
  • Sorun: Otomatik Tamamlama (Yeni) oturum jetonu atlanırsa veya bir oturum sona erdikten sonra yeniden kullanılırsa her istek, SKU: Otomatik Tamamlama İstekleri olarak ayrı ayrı faturalandırılır. Düzeltme: Her oturum için yeni bir oturum jetonu (UUID v4 önerilir) oluşturun ve oturumu Place Details (New) veya Address Validation isteğiyle sonlandırın. /maps/documentation/places/web-service/place-session-tokens adresini inceleyin.
  • Sorun: Eski API'nin etkinleştirilmediği bir projede Places API'yi (eski) veya Maps JavaScript API'yi PlacesService çağıran mevcut ya da yapay zeka tarafından oluşturulan kod, LegacyApiNotActivatedMapError hatasıyla başarısız oluyor. Düzeltme: Çağrıları Places API'ye (Yeni) taşıyın ve gerekli alan maskesini ekleyin. /maps/legacy#LegacyApiNotActivatedMapError sayfasına bakın.
  • Sorun: Depolanan yer kimlikleri geçerliliğini yitirebilir. Bu durumda Yer Ayrıntıları (New) NOT_FOUND (HTTP 404) döndürür, hatalı biçimlendirilmiş veya kesilmiş kimlikler ise HTTP 400 INVALID_ARGUMENT döndürür. Düzeltme: 12 aydan eski kayıtlı yer kimliklerini, yalnızca id alanını isteyen bir Yer Ayrıntıları (Yeni) isteğiyle yenileyin (ücretsiz). /maps/documentation/places/web-service/place-id#refresh-id adresini inceleyin.

Places API (Yeni) ile yapabilecekleriniz

Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.

Places API (Yeni): Üretken yapay zeka

Places API (Yeni): Places