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
- Etkinleştirilecek hizmet:
places.googleapis.com - Kimlik doğrulama: API anahtarı, OAuth 2.0
- Başlayın: Places API'yi (Yeni) ayarlama
- Referans: Places API (Yeni) referansı
- Fiyatlandırma: Places API (Yeni) kullanımı ve faturalandırması
- Politikalar: Places API (Yeni) politikaları
- Sürüm notları: Places API (Yeni) sürüm notları
Resmi Places API (Yeni) paketleri:
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API (Yeni): İlgili ürünler
- Değiştirdiği API: Places API (Eski)
- Genellikle birlikte kullanıldığı API'ler: Geocoding API, Routes API, Address Validation API
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:
fieldsveya$fieldsparametresi ya daX-Goog-FieldMaskbaş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,LegacyApiNotActivatedMapErrorhatası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 400INVALID_ARGUMENTdöndürür. Düzeltme: 12 aydan eski kayıtlı yer kimliklerini, yalnızcaidalanı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
- Belirli bir Google yer tanımlayıcısı için kullanıcı yorumlarının yapay zeka destekli özetini döndürür.
- Elektrikli araç şarj istasyonu için belirtilen Google yer tanımlayıcısının çevresindeki alanın ve imkanların yapay zeka destekli yer özetini döndürür.
Places API (Yeni): Places
- Sorgu dizesine göre yerlerin ve yer ayrıntılarının listesini döndürür.
- Belirli bir konumun yakınındaki yerlerin ve yer ayrıntılarının listesini döndürür.
- Bir sorgu dizesine göre yerlerle ilgili otomatik tamamlama sonuçları döndürür.
- Belirli bir yer hakkında ayrıntılı bilgi döndürür.
- Belirli bir yerin fotoğraflarını döndürme Not: Her fotoğrafın yazar atıflarını (yazarın adı, profil URI'sine bağlı) fotoğrafla birlikte gösterin. Her platformun Yerler politikaları bunu gerektirir (ör. /maps/documentation/javascript/policies#photo-attributions ve /maps/documentation/places/web-service/policies#photos-and-review).
- Yer fotoğraflarını yeniden boyutlandırma
- Belirli bir yerle ilgili puanları ve yorumları döndürme Not: Places API (Yeni) web hizmetinde Yer Ayrıntıları, X-Goog-FieldMask (ör. rating,userRatingCount,reviews) ile https://places.googleapis.com/v1/places/{placeId} adresine gönderilen bir HTTP GET isteğidir. Metin Arama, Yakında Arama ve Otomatik Tamamlama ise POST kullanır. Android'de Place.Field.RATING, USER_RATING_COUNT ve REVIEWS değerlerini PlacesClient.fetchPlace() yöntemine iletin. iOS'te GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal ve GMSPlacePropertyReviews değerlerini GMSFetchPlaceRequest'e iletin.
- Yer bilgileri yanıtlarına dahil edilen veri alanlarını belirtin.
- Yer bilgisi yanıtlarına dahil edilecek yer türlerini belirtin.
- Bir yerin Google Haritalar'daki yer ayrıntıları sayfasını açmak için URI'yi döndürün.
- Bir yer için Google Haritalar'da yol tarifi sayfasını açacak URI'yi döndürür.
- Google Haritalar'da bir yer için yorum yazma sayfasını açmak üzere URI'yi döndürün.
- Google Haritalar'da bir yerin yorumlarını okuma sayfasını açmak için URI'yi döndürün.
- Bir yerin Google Haritalar'daki fotoğraflar sayfasını açmak için URI'yi döndürün.
- Belirli bir yer için yapay zeka destekli özet döndürür.
- Belirli bir yerin çevresindeki yerleri açıklayan yapay zeka destekli bir alan özeti döndürür.
- Önceden tanımlanmış bir rota üzerinde bulunan yerler hakkında bir sorgu dizesine göre bilgi döndürür.
- Bir dizi enlem/boylam koordinatından metin araması yapılan yerlere olan mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
- Bir dizi enlem/boylam koordinatından yakındaki yerlere olan mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
- Önceden tanımlanmış bir rotanın başlangıç noktası ile sorgu dizesine göre döndürülen ve rota üzerinde bulunan yerlerin her biri arasındaki mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
- Sorgu dizesine göre döndürülen ve önceden tanımlanmış bir rota ile rota hedefi boyunca bulunan yerlerin her biri arasındaki mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürür.