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 bakış sunulmaktadır.
Yer Ayrıntıları (Yeni)
Yer kimliği, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz bir şekilde tanımlar. Yer kimliği ile Yer Ayrıntıları (Yeni) isteği göndererek belirli bir tesis veya önemli yer hakkında ayrıntıları isteyebilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yer hakkında tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi kapsamlı bilgiler döndürür.
Yer kimliğini almanın 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)
Yer Fotoğrafı (Yeni) API'sı, Google Rehber veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlayarak uygulamanıza yüksek kaliteli fotoğraf içeriği eklemenize olanak tanır. Place Photo (Yeni) API'sini kullanarak fotoğraflara erişebilir ve resmi, uygulamanız için optimum boyutu elde edecek şekilde yeniden boyutlandırabilirsiniz.
Place Photo (Yeni) API'ye yapılan tüm istekler, döndürülecek fotoğrafı benzersiz şekilde tanımlayan bir fotoğraf kaynağı adı içermelidir. Fotoğraf kaynağı adını aşağıdakileri kullanarak alabilirsiniz:
Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakındaki Arama (Yeni) isteğinin yanıtına fotoğraf kaynağı adını eklemek için isteğin alan maskesine photos alanını eklediğinizden emin olun.
Metin Arama (Yeni) ve Yakındaki Arama (Yeni)
Places API iki arama API'si içerir:
-
Bir yeri aramak için kullanılacak metin dizesi belirtmenizi sağlar. Örneğin: "Sidney, Avustralya'da Lezzetli Vejetaryen Yemekler" veya "Palo Alto, Kaliforniya yakınlarında lezzetli deniz ürünleri restoranları".
Fiyat seviyeleri, mevcut açılış 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 şekillendirebilir veya aramayı belirli bir konumla sınırlandırabilirsiniz.
-
Yer türlerinin bir listesiyle birlikte, arama yapılacak bir bölge belirtebilmenizi sağlar. Bölgeyi, merkez noktanın enlem ve boylam koordinatlarıyla tanımlanan bir daire olarak ve metre cinsinden belirtin.
Yerin özelliklerini tanımlayan bir veya daha fazla yer türü belirtin. Örneğin, belirtilen bölgedeki bir alışveriş merkezinde bulunan pizza restoranını aramak için "
pizza_restaurant" ve "shopping_mall" seçeneklerini belirtin.
İki arama arasındaki temel fark, Metin Arama (Yeni) işlevinin rastgele bir arama dizesi belirtmenize olanak tanırken, Yakındaki Arama (Yeni) özelliğinin arama için belirli bir alan gerektirmesidir.
Otomatik tamamlama (Yeni) ve oturum jetonları
Otomatik Tamamlama (Yeni), HTTP isteğine yanıt olarak yer tahminleri ve sorgu tahminleri döndüren bir web hizmetidir. İstekte, bir metin arama dizesi ve arama alanını kontrol eden coğrafi sınırlar belirtin.
Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını oturum olarak izleyen kullanıcı tarafından oluşturulmuş 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ı 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çeriyor. Bu unsurlar aşağıdaki bölümlerde açıklanmıştır.
Alanlar
Places API (Yeni) birçok yeni alan içeriyor:
| Alan | Açıklama |
|---|---|
regularSecondaryOpeningHours |
Belirli işlemlerin belirli zamanlarını açıklar. İkincil çalışma saatleri, işletmenin ana saatlerinden farklıdır. Örneğin, bir restoran ikincil çalışma saatleri olarak arabayla teslim saatlerini veya teslimat saatlerini belirtebilir. |
paymentOptions |
Mağazanın kabul ettiği ödeme seçenekleri. Bir yer birden fazla ödeme seçeneği kabul edebilir. Ödeme seçeneği verileri mevcut değilse ödeme seçeneği alanı ayarlanmaz. Seçenekler şunlardır:
|
parkingOptions |
Yerin sunduğu park seçenekleri. Seçenekler şunlardır:
|
subDestinations |
Belirli bir yerle ilgili benzersiz yerler. Örneğin, havaalanı terminalleri havaalanının alt hedefleri olarak kabul edilir. |
fuelOptions |
Bir benzin istasyonunda sunulan yakıt seçenekleriyle ilgili en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir. Seçenekler aşağıdakileri içerir:
|
evChargeOptions |
Bu istasyondaki elektrikli araç (EV) şarj noktası sayısı. Bazı EV şarj cihazlarının birden fazla konnektörü varken, her şarj cihazı aynı anda yalnızca bir aracı şarj edebilir. Sonuç olarak, bu alan belirli bir zamandaki kullanılabilir EV şarj noktalarının sayısını gösterir. |
shortFormattedAddress |
Bir yerin kısa, kullanıcılar tarafından okunabilen adresi. |
primaryType |
Belirli bir sonucun birincil türü. Örneğin, bir yer cafe veya airport olarak sınıflandırılabilir. Bir yerin 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 dili için yerelleştirilmiş). Olası değerlerin tam listesi için Desteklenen türler bölümüne bakın. |
Özellikler
Places API (Yeni) birkaç yeni özellik içerir:
| Özellik | Açıklama |
|---|---|
outdoorSeating |
Açık havada oturma alanı vardır. |
liveMusic |
Mekan, canlı müzik performanslarına sahne oluyor. |
menuForChildren |
Yerde çocuk menüsü vardır. |
servesCocktails |
Bu yerde kokteyl servisi vardır. |
servesDessert |
Burada tatlı servisi var. |
servesCoffee |
Bu yerde kahve servisi var. |
goodForChildren |
Yer çocuklar için uygun. |
allowsDogs |
Yer köpeklere izin verir. |
restroom |
Bu yerde tuvalet var. |
goodForGroups |
Yer, gruplar barındırıyor. |
goodForWatchingSports |
Burası, spor etkinliklerini izlemek için uygun. |
Erişilebilirlik seçenekleri
Places API (Yeni) aşağıdaki erişilebilirlik seçeneği alanlarını içerir:
| Alan | Açıklama |
|---|---|
wheelchairAccessibleParking |
Otelde tekerlekli sandalyeye uygun otopark mevcuttur. |
wheelchairAccessibleEntrance |
Yerin tekerlekli sandalyeye uygun girişi vardır. |
wheelchairAccessibleRestroom |
Bu yerde tekerlekli sandalyeye uygun tuvalet var. |
wheelchairAccessibleSeating |
Yerde tekerlekli sandalyeye uygun oturma alanı vardır. |
New Places API'lerine geçiş yapın
Mevcut bir Places API müşterisiyseniz ve yeni API'leri kullanmak üzere uygulamanızı taşımak istiyorsanız aşağıdaki taşıma dokümanlarına bakın: