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, Google Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz ş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ı isteğinde bulunabilirsiniz. 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.
Place Photo (New) 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ğının adını şu şekilde alabilirsiniz:
Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakındakiler Arama (Yeni) isteğinden gelen yanıta fotoğraf kaynağı adını eklemek için isteğin alan maskesine photos alanını eklediğinizden emin olun.
Metin Arama (Yeni) ve Yakında Arama (Yeni)
Yerler API'si 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 lezzetli deniz ürünleri yemekleri".
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 arama yapılacak 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 arabalı sipariş 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 yoksa ödeme seçeneği alanının değeri sıfırlanır. Seçenekler şunlardır:
|
parkingOptions |
Tesisin sunduğu park seçenekleri. Seçenekler şunlardır:
|
subDestinations |
Belirli bir yerle ilgili benzersiz yerler. Örneğin, havaalanı terminalleri bir havaalanı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 şunlardır:
|
evChargeOptions |
Bu istasyondaki elektrikli araç (EV) şarj noktalarının sayısı. Bazı EV şarj noktalarında birden fazla konnektör bulunsa da her şarj noktası aynı anda yalnızca bir aracı şarj edebilir. Bu nedenle bu alan, belirli bir zamanda kullanılabilir EV şarj noktalarının sayısını yansıtır. |
shortFormattedAddress |
Bir yerin kısa ve okunabilir 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), birkaç yeni özellik 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öpeklere izin veriliyor. |
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: