Places API (Yeni), aşağıdaki API'leri içerir:
- Yer Ayrıntıları (Yeni)
- Yer Fotoğrafı (Yeni)
- Yakında Arama (Yeni)
- Metin Arama (Yeni)
- Otomatik tamamlama (Yeni)
Bu belgede, bu yeni API'lere genel bir bakış sunulmaktadır.
Yer Ayrıntıları (Yeni)
Yer kimliği, bir yeri Google Places veritabanında ve Google Haritalar'da benzersiz bir şekilde tanımlar. Yer kimliğiyle, Yer Ayrıntıları (Yeni) isteği göndererek belirli bir tesis veya önemli yer hakkında ayrıntı isteyebilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yerle ilgili tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi kapsamlı bilgiler döndürür.
Yer kimliği edinmenin birçok yolu vardır. Şunları kullanabilirsiniz:
- Metin Arama (Yeni)
- Yakında Arama (Yeni)
- Geocoding API
- Routes API
- Address Validation API
- Otomatik Yer Tamamlama
Yer Fotoğrafı (Yeni)
Place Photo (Yeni) API, Google Yerler veritabanında depolanan milyonlarca fotoğrafa erişim sağlayarak uygulamanıza yüksek kaliteli fotoğraf içerikleri eklemenize olanak tanır. Place Photo (Yeni) API'yi kullanarak fotoğraflara erişebilir ve resmi uygulamanız için en uygun boyuta yeniden boyutlandırabilirsiniz.
Yer Fotoğrafı (Yeni) API'sine gönderilen tüm istekler, döndürülecek fotoğrafı benzersiz şekilde tanımlayan bir fotoğraf kaynağı adı içermelidir. Fotoğraf kaynağının adını şu şekilde edinebilirsiniz:
Fotoğraf kaynağı adını Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakındakiler Arama (Yeni) isteğinin yanıtına eklemek için isteğin alan maskesine photos alanını eklediğinizden emin olun.
Metin Arama (Yeni) ve Yakında Arama (Yeni)
Places API iki arama API'si içerir:
-
Bir yer aramak için kullanılacak metin dizesini belirtmenizi sağlar. Örneğin: "Sidney, Avustralya'da baharatlı vejetaryen yemekler" veya "Palo Alto, CA yakınlarında deniz ürünleriyle ilgili lezzetli yemekler".
Fiyat seviyeleri, mevcut açık olma durumu, puanlar veya belirli yer türleri gibi ayrıntıları belirterek aramayı hassaslaştırabilirsiniz. Ayrıca, sonuçları belirli bir konuma göre yönlendirmeyi veya aramayı belirli bir konumla sınırlandırmayı da belirtebilirsiniz.
-
Yer türlerinin listesinin yanı sıra aranacak bir bölgeyi belirtmenize olanak tanır. Bölgeyi, merkez noktasının enlem ve boylam koordinatları ile yarıçapı (metre cinsinden) tarafından tanımlanan bir daire olarak belirtin.
Yerin özelliklerini tanımlayan bir veya daha fazla yer türü belirtin. Örneğin, belirtilen bölgedeki bir alışveriş merkezinde bulunan bir pizza restoranını aramak için "
pizza_restaurant" ve "shopping_mall"yi belirtin.
Bu iki arama arasındaki temel fark, Metin Arama'nın (Yeni) istediğiniz arama dizesini belirtmenize izin vermesi, Yakındakiler Arama'nın (Yeni) ise aramanın yapılacağı belirli bir alanı gerektirmesidir.
Otomatik Tamamlama (Yeni) ve oturum jetonları
Otomatik Tamamlama (Yeni), bir HTTP isteğine yanıt olarak yer tahminleri ve sorgu tahminleri döndüren bir web hizmetidir. İstekte, arama alanını kontrol eden bir metin arama dizesi ve coğrafi sınırlar belirtin.
Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını oturum olarak izleyen, kullanıcı tarafından oluşturulan dizelerdir. Otomatik Tamamlama (Yeni), kullanıcı otomatik tamamlama aramasının sorgu ve seçim aşamalarını faturalandırma amacıyla ayrı bir oturumda gruplandırmak için oturum jetonlarını kullanır.
Yeni alanlar, özellikler ve erişilebilirlik seçenekleri
Places API (Yeni), kullanıcılara bir yer hakkında daha fazla bilgi sağlamak için yeni alanlar, özellikler ve erişilebilirlik seçenekleri içerir. Bu konular aşağıdaki bölümlerde açıklanmıştır.
Alanlar
Places API (Yeni), birkaç yeni alan içerir:
| Alan | Açıklama |
|---|---|
regularSecondaryOpeningHours |
Belirli işlemler için belirli zamanları açıklar. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran ikincil çalışma saatleri olarak arabaya servis veya teslimat saatlerini belirtebilir. |
paymentOptions |
Yerin kabul ettiği ödeme seçenekleri. Bir yer birden fazla ödeme seçeneğini kabul edebilir. Ödeme seçeneği verileri kullanılamıyorsa ödeme seçeneği alanı ayarlanmamış olur. Seçenekler şunlardır:
|
parkingOptions |
Tesisin sunduğu park seçenekleri. Seçenekler şunlardır:
|
subDestinations |
Belirli bir yerle ilgili benzersiz yerler. Örneğin, havalimanı terminalleri bir havalimanının alt varış noktaları olarak kabul edilir. |
fuelOptions |
Bir benzin istasyonunda sunulan yakıt seçenekleri hakkında en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir. Seçenekler arasında şunlar yer alır:
|
evChargeOptions |
Bu istasyondaki elektrikli araç (EV) şarj cihazı sayısı. Bazı elektrikli araç şarj cihazlarının birden fazla konnektörü olsa da her şarj cihazı aynı anda yalnızca bir aracı şarj edebilir. Bu nedenle, bu alan belirli bir zamanda kullanılabilir durumdaki elektrikli araç şarj cihazlarının sayısını yansıtır. |
shortFormattedAddress |
Bir yerin kısa ve kullanıcıların okuyabileceği adresi. |
primaryType |
Belirtilen sonucun birincil türü. Örneğin, bir yer cafe veya airport olarak sınıflandırılabilir. Bir konumun yalnızca tek bir birincil türü olabilir. Olası değerlerin tam listesi için Desteklenen türler bölümüne bakın. |
primaryTypeDisplayName |
Birincil türün görünen adı (varsa istek diline yerelleştirilmiş). Olası değerlerin tam listesi için Desteklenen türler bölümüne bakın. |
Özellikler
Places API (Yeni), çeşitli yeni özellikler içerir:
| Özellik | Açıklama |
|---|---|
outdoorSeating |
Açık havada oturma alanı mevcuttur. |
liveMusic |
Canlı müzik hizmeti sunan yerler |
menuForChildren |
Çocuk menüsü var. |
servesCocktails |
Burada kokteyl servisi var. |
servesDessert |
Tatlı servisi var. |
servesCoffee |
Kahve servisi var. |
goodForChildren |
Çocuklar için iyi bir yer. |
allowsDogs |
Tesiste köpek kabul ediliyor. |
restroom |
Tesiste tuvalet var. |
goodForGroups |
Yer, gruplara uygundur. |
goodForWatchingSports |
Burası spor etkinliklerini izlemek için uygun bir yer. |
Erişilebilirlik seçenekleri
Places API (Yeni), aşağıdaki erişilebilirlik seçeneği alanlarını içerir:
| Alan | Açıklama |
|---|---|
wheelchairAccessibleParking |
Tekerlekli sandalye kullanıcılarına uygun park yeri mevcuttur. |
wheelchairAccessibleEntrance |
Tesisin tekerlekli sandalye kullanıcılarına uygun girişi var. |
wheelchairAccessibleRestroom |
Tesiste tekerlekli sandalye kullanıcılarına uygun tuvalet var. |
wheelchairAccessibleSeating |
Tekerlekli sandalye kullanıcılarına uygun oturma düzeni var. |
Yeni Places API'lerine geçiş
Mevcut bir Places API müşterisiyseniz ve uygulamanızı yeni API'leri kullanacak şekilde taşımak istiyorsanız aşağıdaki taşıma dokümanlarına bakın: