Yeni Yer Ayrıntıları, Yakında Arama ve Metin Arama API'lerinin yanıt biçimi, mevcut API'lerin biçiminden farklıdır. Temel fark, Yer nesnesi yanıtında yapılan değişiklikler bölümünde açıklandığı gibi, her yöntemin döndürdüğü Place nesnesinin biçimindedir.
Ayrıca, yanıt nesnesinin üst düzey alanları da her API için değişti. Şu konulara göz atın:
- Metin arama yanıtı değişiklikleri
- Yakındakiler araması yanıtında yapılan değişiklikler
- Yer Ayrıntıları yanıtında yapılan değişiklikler
Yanıt yer nesnesinde yapılan değişiklikler
Bu tabloda, Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) yanıtlarında mevcut
Place nesnesi ile karşılaştırmalı olarak yeni
Place nesnesinde 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 Place nesnesi | Yeni yer nesnesi | Notlar |
|---|---|---|---|
| Adres bileşeni | address_components |
addressComponents |
|
| Yer mikro biçimi adresi | adr_address |
adrFormatAddress |
|
| İşletme durumu | business_status |
businessStatus |
|
| Önümüzdeki haftanın ç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 ilişkilendirmeleri | html_attributions |
attributions |
Mevcut API'lerdeki yanıtın üst düzey alanı |
| Simge URL'si | icon |
Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor özelliğini kullanın. Daha fazla bilgi için Simgeleri yerleştirme 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.text olarak ve language olarak displayName.languageCode |
| Çalışma saatleri | opening_hours |
regularOpeningHours |
|
| Fotoğraflar | photos |
photos |
Yeni Place nesnesinde photos biçimi değişti. Daha fazla bilgi için Fotoğraf referanslarına geçme başlıklı makaleyi inceleyin. |
| Yer kimliği | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Fiyat düzeyi | price_level |
priceLevel |
|
| Derecelendirme | rating |
rating |
|
| Yorumlar | reviews |
reviews |
|
| İstisnalar ve diğer tüm verilerle birlikte, bugünden itibaren önümüzdeki 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çe dahil olmak üzere adresin kısa formu | vicinity |
shortFormattedAddress |
|
| Yerin web sitesi | website |
websiteUri |
|
| Tekerlekli sandalyeye uygunluk bilgileri | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance şu anda accessibilityOptions.wheelchairAccessibleEntrance |
| Yer ö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 formundaki name alanı |
Mevcut API'de name alanı, yer adını metin dizesi olarak içeriyordu. Yeni API'de bu bilgiler displayName içindedir. |
|
| Yerin birincil türü | primaryTypeName |
Yeni | |
| Birincil türü metin dizesi olarak yerleştirme | primaryTypeDisplayName |
Yeni | |
| İstisnalar ve diğer tüm verilerle birlikte normal haftalık ikincil çalışma saatleri | regularSecondaryOpeningHours |
Yeni | |
| Yerin kabul ettiği ödeme seçenekleri | paymentOptions |
Yeni | |
| Yer park seçenekleri | parkingOptions |
Yeni | |
| Yerle ilgili alt hedeflerin listesi | subDestinations |
Yeni | |
| Benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler | fuelOptions |
Yeni | |
| Bir yerle ilgili elektrikli araç şarjı bilgileri | evChargeOptions |
Yeni | |
| Yer ö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 nesnesinde 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 ilişkilendirmeleri | html_attributions |
Her yer için place.attributions olarak yeni Place nesnesine taşındı |
|
| Yer dizisi | Mevcut Place nesnesinin results dizisi |
places yeni Place nesnesi dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| 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ında Arama yanıtı değişiklikleri
Aşağıdaki tabloda, mevcut Yakındaki Arama için yanıt nesnesinin üst düzey alanlarında ve Yakındaki Arama (Yeni) için yanıt nesnesinde yapılan değişiklikler gösterilmektedir. Yeni API'de, yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yakında Arama (Mevcut) | Yakında Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her bir yer için place.attributions olarak yeni Place nesnesine taşındı |
|
| Yer dizisi | 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ı | |
| 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ında yapılan değişiklikler
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 nesnesinde 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 ilişkilendirmeleri | html_attributions |
Yeni Yer nesnesine attributions olarak taşındı |
|
| Yer ayrıntıları | Mevcut Yer nesnesini içeren result |
Yeni Yer 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ı |