Yeni Yer Ayrıntıları, Yakında Arama ve Metin Arama API'lerinin yanıt biçimi, mevcut API'lerin biçiminden farklı şekilde değiştirilmiştir. Temel fark, Yanıt Yer nesnesindeki değişiklikler konusunda açıklandığı gibi her bir yöntemin döndürdüğü Place nesnesinin biçimindedir.
Buna ek olarak, her API için yanıt nesnesinin üst düzey alanları da değişti. Bkz.:
- Metin Arama yanıt değişiklikleri
- Yakında Arama yanıtıyla ilgili değişiklikler
- Yer Ayrıntıları yanıt değişiklikleri
Yanıttaki Yer nesnesindeki değişiklikler
Bu tabloda Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) yanıtındaki yeni
Place nesne ile mevcut
Place nesne karşılaştırılarak yapılan değişiklikler gösterilmektedir.
Yeni yanıt nesnesi, alan adları için büyük/küçük harf kullanımını kullanır, yeni alanlar içerir ve mevcut alanların bazılarını yeniden adlandırır.
| Alan | Mevcut Yer nesnesi | Yeni Yer nesnesi | Notlar |
|---|---|---|---|
| Adres bileşeni | address_components |
addressComponents |
|
| Mikro biçim adresini yerleştir | adr_address |
adrFormatAddress |
|
| İşletmenin durumu | business_status |
businessStatus |
|
| Gelecek hafta çalışma saatleri | current_opening_hours |
currentOpeningHours |
|
| İçerik özeti | editorial_summary |
editorialSummary |
|
| Biçimlendirilmiş adres | formatted_address |
formattedAddress |
|
| Ulusal telefon numarası | formatted_phone_number |
nationalPhoneNumber |
|
| Konum | geometry.location |
location |
|
| Görüntü alanı | geometry.viewport |
viewport |
|
| Yer atıfları | html_attributions |
attributions |
Mevcut API'lerdeki yanıtın üst düzey alanı |
| Simge URL'si | icon |
Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor kullanın. Daha fazla bilgi için Yer simgeleri bölümüne bakın. |
|
| Simge arka plan rengi | icon_background_color |
iconBackgroundColor |
|
| Simge maskesi URL'si | icon_mask_base_uri |
iconMaskBaseUri |
|
| Uluslararası telefon numarası | international_phone_number |
internationalPhoneNumber |
|
| Metin yer adı | name |
displayName |
Metin yer adına artık displayName.languageCode ve displayName.text olarak
language erişilebilir |
| Çalışma saatleri | opening_hours |
regularOpeningHours |
|
| Fotoğraflar | photos |
photos |
Yeni Place nesnesinde photos öğesinin biçimi değişti. Daha fazla bilgi için Fotoğraf referanslarında değişiklik yapma bölümüne bakın. |
| Yer kimliği | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Fiyat düzeyi | price_level |
priceLevel |
|
| Derecelendirme | rating |
rating |
|
| İnceleme durumu | reviews |
reviews |
|
| İstisnalar ve diğer tüm veriler dahil olmak üzere bugünden itibaren gelecek hafta için ikincil çalışma saatleri | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Yer türleri | types |
types |
|
| Yerin Google Haritalar URL'si | url |
googleMapsUri |
|
| Kullanıcı puanı sayısı | user_ratings_total |
userRatingCount |
|
| UTC farkı | utc_offset |
utcOffsetMinutes |
|
| Sokak adı ve ilçeyi içeren kısa adres biçimi | vicinity |
shortFormattedAddress |
|
| Yer web sitesi | website |
websiteUri |
|
| Tekerlekli sandalyeyle erişilebilirlik bilgileri | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance şu anda accessibilityOptions.wheelchairAccessibleEntrance konumunda |
| Yerler özellikleri | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Kaynak adı | places/PLACE_ID biçimindeki name alanı |
Mevcut API'de name alanı, yer adını bir metin dizesi olarak içeriyordu. Yeni API'de bu bilgi displayName içinde yer alır. |
|
| Birincil türü yerleştir | primaryTypeName |
Yeni | |
| Birincil türü metin dizesi olarak yerleştir | primaryTypeDisplayName |
Yeni | |
| İstisnalar ve diğer tüm verilerle birlikte normal haftalık ikincil çalışma saatleri | regularSecondaryOpeningHours |
Yeni | |
| Mağazanın kabul ettiği ödeme seçenekleri | paymentOptions |
Yeni | |
| Park yeri seçenekleri | parkingOptions |
Yeni | |
| Yerle ilgili alt hedeflerin listesi | subDestinations |
Yeni | |
| Benzin istasyonundaki yakıt seçenekleriyle ilgili en son bilgiler | fuelOptions |
Yeni | |
| Bir yer için EV şarj bilgileri | evChargeOptions |
Yeni | |
| Yerler özellikleri | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Yeni |
Metin Arama yanıt değişiklikleri
Aşağıdaki tabloda, mevcut Metin Arama için yanıt nesnesinin üst düzey alanlarında ve Metin Arama (Yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Metin Arama (Mevcut) | Metin Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer atıfları | html_attributions |
Her yer için yeni Yer nesnesine place.attributions olarak taşındı |
|
| Bir dizi yer | Mevcut Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı | |
| Tüm hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yakındaki Arama yanıtı değişiklikleri
Aşağıdaki tabloda, mevcut Yakındaki Arama'nın yanıt nesnesinin üst düzey alanlarında ve Yakındaki Arama (Yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yakındaki Arama (Mevcut) | Yakındaki Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer atıfları | html_attributions |
Her yer için yeni Yer nesnesine (place.attributions) taşındı |
|
| Bir dizi yer | Mevcut Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı | |
| Tüm hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yer Ayrıntıları yanıt değişiklikleri
Aşağıdaki tabloda, mevcut Yer Ayrıntıları için yanıt nesnesinin üst düzey alanlarında ve Yer Ayrıntıları (Yeni) için yanıt nesnesi için yapılan değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yer Ayrıntıları (Mevcut) | Yer Ayrıntıları (Yeni) | Notlar |
|---|---|---|---|
| Yer atıfları | html_attributions |
attributions olarak yeni Yer nesnesine taşındı |
|
| Yer ayrıntıları | Mevcut Place nesnesini içeren result |
Yeni Place nesnesi | |
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı | |
| Tüm bilgi mesajları | info_messages |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı |