Places API'yi neden kullanmalısınız?
Kullanıcılarınızın ayrıntılı konum verilerine kolayca ulaşmasını sağlamak için konuma duyarlı özellikler oluşturun. Places API ile kullanılabilir veriler, en doğru, en güncel ve gerçeğe dair kapsamlı yer modelleri oluşturmaktır. Aşağıda, uygulamalara ilişkin örnek kullanım alanları verilmiştir:
- Özel olarak şehirleri hedefleyen sonuçlarla birlikte büyük metropol bölgelerdeki kiralık daireleri görüntüleyin.
- Teslim alma veya teslimat durumu güncellemesine yer ayrıntılarını ekleyin.
- Bir bölgedeki parkların listesini, kullanıcı tarafından gönderilen fotoğraflar ve yorumlarla birlikte görüntüleyin.
- Seyahat planlayan kullanıcılara, seyahat eden kuruluşlarla ilgili iletişim bilgileri, yorumlar ve fiyat seviyeleri sağlayın.
Places API ile yapabilecekleriniz
Rehber API'sini kullanarak, aşağıdaki özellikleri sayfanıza uygulamalar:
- Farklı türdeki kullanıcı sorgularından yer arama sonuçları sağlayın (örneğin, metin girişi, yakındaki konumlar ve muğlak veya kategorik kullanıcı sorguları.
- Belirli metin sorguları gibi farklı arama türleri için otomatik tamamlama özelliklerini etkinleştirin emin olun.
- Bir yer hakkında döndürülen ayrıntıları (ör. çalışma saatleri, özet, özet) bir fotoğraf ekleyin.
- Uygulamanızın sunduğu konumlara yüksek kaliteli fotoğraflar ekleyin.
Birçok Google Maps Platform API'si, yer kimlikleri; burada yer kimliği benzersiz bir şekilde Google Rehber veritabanında ve Google Haritalar'da bir yeri belirlediğinde. Yer kimliği edinmenin birçok yolu vardır. Bunun için Places API'nin yanı sıra Geocoding API, Routes API ve Address Validation API'yi de kullanabilirsiniz.
Yer kimliğinizi oluşturduktan sonra, bir yerle ilgili daha fazla ayrıntı istemek için Places API'sini yer (ör. tam adresi, telefon numarası, e-posta adresi, ve kullanıcı yorumları.
Places API sürümünüzü seçin
Places API, iki API sürümünü destekler: Places API, mevcut API'leri ve Places API'sini (Yeni), API'lerin yeni nesil sürümleridir.
Places API'nin (Yeni) kullanıma sunulmasıyla birlikte ilk göreviniz, hangi işletmenin API seti var. Bu durum, yeni veya mevcut bir müşteriyseniz kullandığının bir göstergesi. Tekliflerinizi otomatikleştirmek ve optimize etmek için bu rehberi ve iki API arasındaki farklar.
Places API'nin işleyiş şekli
Places API (Yeni)
Places API (Yeni), belirli bir
hizmet uç noktası, örneğin /places
veya places:searchText
ve bir JSON yanıtı döndürür. Places API (Yeni), şuna göre yetkilendirmeyi destekliyor:
API anahtarı ve OAuth jetonu.
Aşağıdaki örnekte, bir sitenin adres bileşenlerini döndürmek için Yer Ayrıntısı isteğinde bulunur.
API anahtarı kullanan yer kimliği:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API, istekleri belirli bir
hizmet uç noktası, örneğin /place
veya /photo
. Uç noktalar ayrıca
istekte belirtilen biçim türünü (JSON veya XML) kabul etmelidir. Hizmet
isteği, döndürülen verileri hassaslaştırmak için söz konusu uç noktayla alakalı parametreleri kullanır.
Aşağıdaki örnekte, bir sitenin adres bileşenlerini döndürmek için Yer Ayrıntısı isteğinde bulunur.
JSON biçiminde yer kimliği:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
Bu durumda, hizmet istenen yeri ve bu yeri bulmak için sağlanan yer kimliğini kullanır. adres bileşenlerini JSON biçiminde döndürün.
Kaynaklar
Aşağıdaki tabloda, Yerler API'si.
Places API | Places API (Yeni) | Not |
---|---|---|
Yer Bulma | Metin Arama (Yeni) | Yer Bulma uygulamasının yeni bir sürümü yok. Bunun yerini Metin Arama (Yeni) aldı. |
Yakında Arama | Yakında Arama (Yeni) | Metin sorgusu içeren mevcut API'yi kullanan tüm istekler Metin Arama (Yeni) çünkü Yakındaki Arama (Yeni) metin girişini desteklemiyor. |
Metin Arama | Metin Arama (Yeni) | |
Yer Ayrıntıları | Yer Ayrıntıları (Yeni) | |
Yer Fotoğrafı | Yer Fotoğrafı (Yeni) | |
Otomatik Yer Tamamlama | Otomatik tamamlama (Yeni) | |
Sorgu Otomatik Tamamlama | Otomatik tamamlama (Yeni) | Otomatik tamamlamaya özellikler eklendi (Yeni) |
Places API'yi kullanma
Aşağıdaki adımlar, Places API hizmetinin kullanımına ilişkin tipik bir kullanım alanı senaryosunu kapsamaktadır. Geliştirme sırasında Yakındaki Arama ve Yer Fotoğrafları gibi ek uç noktaları kullanabilirsiniz.1 | Kurulumu yapın | Ayarlarınızı Google Cloud projesine giriş yapın ve aşağıdaki kurulum talimatlarını uygulayın, ardından API anahtarınızı nasıl kullanacağınızı öğrenin. Places API (Yeni) için şunları da kullanabilirsiniz: OAuth jetonları. |
2 | Temel metin aramasını deneyin | Metin Arama (Yeni) özelliğini kullanarak basit bir metin araması yapın veya Metin Arama. |
3 | Daha fazla ayrıntı için yer kimliğini kullanın | Birçok Google Haritalar Platformu API'si yanıt kapsamında bir yer kimliği döndürür. Şunu kullanın: bir yer hakkındaki ayrıntıları almak için yer kimliğini kullanın. Yer Ayrıntıları (Yeni) ve Yer Ayrıntıları bölümlerine bakın. |
4 | Bir yerin fotoğrafını alma | Yer Fotoğrafı hizmeti, Yerler'de depolanan milyonlarca fotoğrafa erişmenizi sağlar Yer Fotoğrafı (Yeni) seçeneğini kullanın. veya Yer Ayrıntıları bir yerin fotoğraflarına erişmek için. |