Yer Bulma (Eski)

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Yer Bulma (Eski) isteği, metin girişi alır ve yer döndürür. Giriş, ad, adres veya telefon numarası gibi herhangi bir Yer metin verisi olabilir. İstek bir dize olmalıdır. Dize olmayan veriler (ör. enlem/boylam koordinatı veya artı kodu) kullanılarak yapılan Yer Bulma (Eski) isteği hata oluşturur.

Yer Bulma (Eski) istekleri

Yer Bulma (Eski) isteği, aşağıdaki biçimde bir HTTP URL'sidir:

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

Burada output aşağıdaki değerlerden biri olabilir:

  • json (önerilir) JavaScript Object Notation (JSON) biçiminde çıktı olduğunu gösterir.
  • xml, çıkışın XML olarak gösterileceğini belirtir.

Yer Bulma (Eski) isteği başlatmak için belirli parametreler gerekir. URL'lerde standart olduğu gibi, tüm parametreler "ve" işareti (&) kullanılarak ayrılır.

Gerekli parametreler

  • giriş

    Aranacak metin dizesi. Örneğin: "restaurant" veya "123 Main Street". Bu, bir yer adı, adres veya kuruluş kategorisi olmalıdır. Diğer giriş türleri hata oluşturabilir ve geçerli sonuçlar döndüreceği garanti edilmez. Places API, bu dizeye göre aday eşleşmeler döndürür ve sonuçları algılanan alaka düzeylerine göre sıralar.

  • inputtype

    Girişin türü. Bu, textquery veya phonenumber olabilir. Telefon numaraları uluslararası standartta olmalıdır (artı işareti ("+") ile başlayıp ülke kodu ve telefon numarasıyla devam eder). Daha fazla bilgi için E.164 ITU önerisi başlıklı makaleyi inceleyin.

İsteğe bağlı parametreler

  • Fields

    Dikkat: Yer Arama istekleri ve Yer Ayrıntıları istekleri aynı alanları döndürmez. Yer Arama istekleri, Yer Ayrıntıları istekleri tarafından döndürülen alanların bir alt kümesini döndürür. İstediğiniz alan Yer Arama tarafından döndürülmüyorsa place_id almak için Yer Arama'yı kullanabilir, ardından Yer Ayrıntıları isteği göndermek için bu yer kimliğini kullanabilirsiniz. Yer Arama isteğinde kullanılamayan alanlar hakkında daha fazla bilgi için Places API alan desteği başlıklı makaleyi inceleyin.

    Döndürülecek virgülle ayrılmış yer verisi türleri listesini belirtmek için fields parametresini kullanın. Örneğin: fields=formatted_address,name,geometry. Bileşik değerleri belirtirken eğik çizgi kullanın. Örneğin: opening_hours/open_now.

    Alanlar üç faturalandırma kategorisine ayrılır: Temel, Kişi ve Atmosfer. Temel alanlar taban fiyat üzerinden, Kişi ve Atmosfer alanları ise daha yüksek bir fiyat üzerinden faturalandırılır. Temel, Kişi ve Atmosfer SKU'ları, bunları tetikleyen istek için temel SKU'ya (Yer Ayrıntıları, Yer Bulma, Yakında Arama veya Metin Arama) ek olarak ücretlendirilir. Daha fazla bilgi için fiyatlandırma sayfasını inceleyin.

    Temel

    Temel kategoride şu alanlar bulunur: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (kullanımdan kaldırıldı), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

    İletişim

    Kişi kategorisi aşağıdaki alanları içerir: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

    Atmosfer

    Atmosfer kategorisi aşağıdaki alanları içerir: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

    Not: Alan istenmiş olsun veya olmasın, atıflar html_attributions her zaman her aramada döndürülür.

  • language

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediği için bu liste kapsamlı olmayabilir.
    • language sağlanmazsa API, Accept-Language üstbilgisinde belirtilen tercih edilen dili kullanmaya çalışır.
    • API, hem kullanıcı hem de yerel halk için okunabilir bir açık adres sağlamak üzere elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak gerekirse kullanıcının okuyabileceği bir alfabeye çevrilmiş, yerel dildeki açık adresleri döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü aynı dilde döndürülür. Bu dil, ilk bileşenden seçilir.
    • Bir ad tercih edilen dilde kullanılamıyorsa API en yakın eşleşmeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar. Örneğin, Macarca'da utca ve tér, sokak kelimesinin eş anlamlılarıdır.

  • locationbias

    Yarıçap ve enlem/boylam ya da bir dikdörtgenin noktalarını temsil eden iki enlem/boylam çifti belirterek belirli bir alandaki sonuçları tercih edin. Bu parametre belirtilmezse API, varsayılan olarak IP adresi önyargısını kullanır.

    • IP önyargısı: API'ye IP adresi önyargısı kullanması talimatını verir. Dizeyi iletin. ipbias (Bu seçeneğin ek parametreleri yoktur).
    • Dairesel: Yarıçapı metre cinsinden belirten bir dize ve ondalık derece cinsinden enlem/boylam. Şu biçimi kullanın: circle:radius@lat,lng.
    • Dikdörtgen: Bir dikdörtgenin güney/batı ve kuzey/doğu noktalarını temsil eden, ondalık derece cinsinden iki enlem/boylam çifti belirten bir dize. Aşağıdaki biçimi kullanın:rectangle:south,west|north,east. Doğu/batı değerlerinin -180 ile 180 aralığına, kuzey/güney değerlerinin ise -90 ile 90 aralığına kaydırıldığını unutmayın.

Yer Bulma (Eski) örnekleri

Aşağıdaki örnekte "Avustralya Modern Sanat Müzesi" için photos, formatted_address, name, rating, opening_hours ve geometry alanlarını içeren bir Yer Bulma (Eski) isteği gösterilmektedir:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

Aşağıdaki örnekte, belirtilen koordinatların 2.000 metre içindeki sonuçları tercih etmek için locationbias parametresinin kullanıldığı "Mongolian Grill" için bir Yer Bulma (Eski) isteği gösterilmektedir:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

Aşağıdaki örnekte, telefon numarası için bir Yer Bulma (Eski) isteği gösterilmektedir. Bu isteğin uyumlu bir URL olması için uluslararası arama önekindeki "+" işaretinin %2B olarak kodlandığını unutmayın. Kodlanmadan bırakılan + öneki, sunucuda boşluk olarak çözülür ve bu da geçersiz bir telefon numarası aramasıyla sonuçlanır.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Yer Bulma (Eski) yanıtları

Yer Bulma (Eski) yanıtı yalnızca fields parametresi kullanılarak belirtilen veri türlerini ve html_attributions içerir. Aşağıdaki örnekte, "Avustralya Modern Sanat Müzesi" için formatted_address, geometry, name, opening_hours, photos ve rating alanlarını içeren bir Yer Bulma (Eski) isteğinin yanıtı gösterilmektedir.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

Alan Zorunlu Tür Açıklama
required Array<Place>

Bir dizi yer adayı içerir.

Yer Arama istekleri, Yer Ayrıntıları istekleri tarafından döndürülen alanların bir alt kümesini döndürür. İstediğiniz alan Yer Arama tarafından döndürülmüyorsa Yer Arama'yı kullanarak bir place_id alabilir, ardından bu yer kimliğini kullanarak Yer Ayrıntıları isteği oluşturabilirsiniz.

Daha fazla bilgi için Yer'i inceleyin.
required PlacesSearchStatus

İsteğin durumunu içerir ve isteğin neden başarısız olduğunu bulmanıza yardımcı olacak hata ayıklama bilgileri içerebilir.

Daha fazla bilgi için PlacesSearchStatus bölümünü inceleyin.

isteğe bağlı dize

Hizmet OK< dışında bir durum kodu döndürdüğünde yanıt nesnesinde ek bir error_message alanı olabilir. Bu alan, verilen durum kodunun nedenleri hakkında daha ayrıntılı bilgiler içerir. Bu alan her zaman döndürülmez ve içeriği değişebilir.

isteğe bağlı Array<string>

Hizmet, istek spesifikasyonu hakkında ek bilgiler döndürdüğünde yanıt nesnesinde ek bir info_messages alanı olabilir. Bu alan yalnızca başarılı istekler için döndürülür. Bu sonuç her zaman döndürülmeyebilir ve içeriği değişebilir.

PlacesSearchStatus

Hizmet tarafından döndürülen durum kodları.

  • OK, API isteğinin başarılı olduğunu gösterir.
  • ZERO_RESULTS, aramanın başarılı olduğunu ancak sonuç döndürmediğini gösterir. Bu durum, arama uzak bir konumda latlng ile yapıldıysa ortaya çıkabilir.
  • API isteğinin hatalı biçimlendirildiğini gösterir. Genellikle gerekli sorgu parametresinin (location veya radius) eksik olmasından kaynaklanır.INVALID_REQUEST
  • OVER_QUERY_LIMIT aşağıdakilerden herhangi birini gösteriyorsa:
    • Saniyedeki sorgu sınırlarını aştınız.
    • Hesabınızda faturalandırma etkinleştirilmemiştir.
    • Aylık 200 ABD doları kredi veya kendinizin belirlediği kullanım sınırı aşılmıştır.
    • Belirtilen ödeme yöntemi artık geçerli değil (ör. kredi kartının süresi dolmuş).
    Bu hatayı nasıl gidereceğiniz hakkında daha fazla bilgi için Haritalar SSS bölümüne bakın.
  • REQUEST_DENIED. Bu e-postada, isteğinizin reddedildiği belirtilir. Bunun nedeni genellikle:
    • İstek API anahtarı içermiyor.
    • key parametresi geçersiz.
  • UNKNOWN_ERROR bilinmeyen bir hatayı gösterir.

Yer

Bir yeri tanımlayan özellikler. Tüm özellikler tüm yer türlerinde kullanılamaz.

Alan Zorunlu Tür Açıklama
isteğe bağlı Array<AddressComponent>

Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi.

Daha fazla bilgi için AddressComponent sayfasına göz atın.

isteğe bağlı dize

Yer adresinin adr mikro biçimindeki gösterimi.

isteğe bağlı dize

İşletme ise yerin operasyonel durumunu gösterir. Veri yoksa business_status döndürülmez.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
isteğe bağlı boolean

İşletmenin arabaya teslim alma hizmetini destekleyip desteklemediğini belirtir.
isteğe bağlı PlaceOpeningHours

Önümüzdeki yedi günün (bugün dahil) çalışma saatlerini içerir. Dönem, istek tarihinde gece yarısında başlar ve altı gün sonra saat 23:59'da sona erer. Bu alan, özel çalışma saatleri olan tarihler için ayarlanan tüm saatlerin special_days alt alanını içerir.

Daha fazla bilgi için PlaceOpeningHours'u inceleyin.

isteğe bağlı boolean

İşletmenin teslimatı destekleyip desteklemediğini belirtir.
isteğe bağlı boolean

İşletmenin kapalı veya açık havada oturma alanı seçeneklerini destekleyip desteklemediğini belirtir.

isteğe bağlı PlaceEditorialSummary

Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve geçerli durumlarda bu metinlerin dil kodunu da içerir. Özet metni olduğu gibi sunulmalı, değiştirilmemeli veya üzerinde oynanmamalıdır.

Daha fazla bilgi için PlaceEditorialSummary bölümüne bakın.

isteğe bağlı dize

Bu yerin okunabilir adresini içeren bir dize.

Bu adres genellikle posta adresine eşdeğerdir. Birleşik Krallık gibi bazı ülkelerde lisanslama kısıtlamaları nedeniyle gerçek posta adreslerinin dağıtımına izin verilmediğini unutmayın.

Biçimlendirilmiş adres, mantıksal olarak bir veya daha fazla adres bileşeninden oluşur. Örneğin, "111 8th Avenue, New York, NY" adresi şu bileşenlerden oluşur: "111" (sokak numarası), "8th Avenue" (yol), "New York" (şehir) ve "NY" (ABD eyaleti).

Biçimlendirilmiş adresi programatik olarak ayrıştırmayın. Bunun yerine, API yanıtının biçimlendirilmiş adres alanına ek olarak içerdiği bağımsız adres bileşenlerini kullanmanız gerekir.

isteğe bağlı dize

İşletmenin telefon numarasını yerel biçimde içerir.

isteğe bağlı Geometry

Konumun yerini ve görünüm alanını içerir.

Daha fazla bilgi için Geometry sayfasına göz atın.
isteğe bağlı dize

Bu sonucu haritada belirtirken kullanıcıya gösterilebilecek önerilen simgenin URL'sini içerir.

isteğe bağlı dize

Yer kategorisinin varsayılan onaltılık renk kodunu içerir.
isteğe bağlı dize

.svg veya .png dosya türü uzantısı hariç olmak üzere, önerilen bir simgenin URL'sini içerir.

isteğe bağlı dize

İşletmenin uluslararası standarda uygun telefon numarasını içerir. Uluslararası standartta ülke kodu bulunur ve numaranın başına artı (+) işareti eklenir. Örneğin, Google'ın Sidney, Avustralya ofisinin international_phone_number değeri +61 2 9374 4000'dır.

isteğe bağlı dize

Döndürülen sonucun kullanıcılar tarafından okunabilen adını içerir. establishment sonuçlarında bu genellikle kurallı işletme adıdır.

isteğe bağlı PlaceOpeningHours

Normal çalışma saatlerini içerir.

Daha fazla bilgi için PlaceOpeningHours'u inceleyin.

isteğe bağlı boolean

İşletmelerin operasyonel durumunu öğrenmek için business_status kullanın.

isteğe bağlı Array<PlacePhoto>

Her biri bir resme referans içeren fotoğraf nesneleri dizisi. Bir istek en fazla on fotoğraf döndürebilir. Yer fotoğrafları ve bu resimleri uygulamanızda nasıl kullanabileceğiniz hakkında daha fazla bilgiyi Yer Fotoğrafları dokümanında bulabilirsiniz.

Daha fazla bilgi için PlacePhoto bölümüne bakın.
isteğe bağlı dize

Bir yeri benzersiz şekilde tanımlayan metin tanımlayıcısı. Yerle ilgili bilgileri almak için bu tanımlayıcıyı bir Places API isteğinin place_id alanına iletin. Yer kimlikleri hakkında daha fazla bilgi için Yer kimliği genel bakışı başlıklı makaleyi inceleyin.

isteğe bağlı PlusCode

Enlem ve boylam koordinatlarından elde edilen, kodlanmış bir konum referansı. Bir alanı temsil eder: 1/8000 dereceye 1/8000 derece (Ekvator'da yaklaşık 14 m x 14 m) veya daha küçük. Plus code'lar, sokak adreslerinin olmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerler) sokak adreslerinin yerine kullanılabilir. Open Location Code ve plus kodları başlıklı makalelere göz atın.

Daha fazla bilgi için PlusCode sayfasına göz atın.
isteğe bağlı sayı

Yerin fiyat düzeyi (0-4 ölçeğinde). Belirli bir değerle belirtilen tam tutar bölgeden bölgeye değişir. Fiyat seviyeleri aşağıdaki gibi yorumlanır:

  • 0 Ücretsiz
  • 1 Uygun fiyatlı
  • 2 Orta
  • 3 Pahalı
  • 4 Çok Pahalı
isteğe bağlı sayı

Toplanan kullanıcı yorumlarına göre yerin 1, 0 ile 5, 0 arasındaki puanını içerir.

isteğe bağlı dize
isteğe bağlı boolean

Mekanın rezervasyonları destekleyip desteklemediğini belirtir.
isteğe bağlı Array<PlaceReview>

En fazla beş yorum içeren bir JSON dizisi. Yorumlar varsayılan olarak alaka düzeyine göre sıralanır. Sıralamayı kontrol etmek için reviews_sort istek parametresini kullanın.

  • most_relevant (varsayılan) için yorumlar alaka düzeyine göre sıralanır. Hizmet, sonuçları tercih edilen dilde yazılmış yorumları döndürecek şekilde yönlendirir.
  • newest için yorumlar kronolojik sıraya göre sıralanır. Tercih edilen dil, sıralama düzenini etkilemez.

Google, kullanıcılara sonuçların most_relevant veya newest'ye göre sıralanıp sıralanmadığını belirtmenizi önerir.

Daha fazla bilgi için PlaceReview sayfasına göz atın.

isteğe bağlı dize
isteğe bağlı Array<PlaceOpeningHours>

İşletmenin ikincil çalışma saatleri hakkında bilgiler de dahil olmak üzere önümüzdeki yedi gün için bir dizi giriş içerir. İkincil çalışma saatleri, işletmenin temel çalışma saatlerinden farklıdır. Örneğin, bir restoran, ikinci çalışma saatleri olarak arabaya servis saatlerini veya teslimat saatlerini belirtebilir. Bu alan, yer türlerine göre çalışma saatleri türlerinin (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) önceden tanımlanmış bir listesinden alınan type alt alanını doldurur. Bu alan, özel çalışma saatleri olan tarihler için ayarlanan tüm saatlerin special_days alt alanını içerir.

Daha fazla bilgi için PlaceOpeningHours'u inceleyin.

isteğe bağlı boolean

Mekanda bira servisi yapılıp yapılmadığını belirtir.
isteğe bağlı boolean

Mekanda kahvaltı servisi olup olmadığını belirtir.
isteğe bağlı boolean

Mekanda geç kahvaltı servisi olup olmadığını belirtir.
isteğe bağlı boolean

Mekanda akşam yemeği servisi olup olmadığını belirtir.
isteğe bağlı boolean

Mekanda öğle yemeği servisi yapılıp yapılmadığını belirtir.
isteğe bağlı boolean

Mekanda vejetaryen yemek servisi olup olmadığını belirtir.
isteğe bağlı boolean

Mekanda şarap servisi olup olmadığını belirtir.
isteğe bağlı boolean

İşletmenin paket servisi seçeneğini destekleyip desteklemediğini belirtir.
isteğe bağlı Array<string>

Belirli bir sonucu açıklayan özellik türlerinin dizisini içerir. Desteklenen türlerin listesine bakın.

isteğe bağlı dize

Bu yerin resmi Google sayfasının URL'sini içerir. Bu, yerle ilgili mevcut en iyi bilgileri içeren ve Google'a ait olan sayfadır. Uygulamalar, kullanıcıya yerle ilgili ayrıntılı sonuçları gösteren tüm ekranlarda bu sayfaya bağlantı vermelidir veya bu sayfayı yerleştirmelidir.

isteğe bağlı sayı

Bu yerle ilgili toplam yorum sayısı (metin içeren veya içermeyen).

isteğe bağlı sayı

Bu yerin geçerli saat diliminin UTC'den kaç dakika farklı olduğunu gösterir. Örneğin, Avustralya'nın Sidney şehrinde yaz saati uygulaması sırasında bu değer 660 (+UTC'den 11 saat) olurken Kaliforniya'da yaz saati uygulaması dışında bu değer -480 (-UTC'den 8 saat) olur.

isteğe bağlı dize

Yalnızca kuruluş (types:["establishment", ...]) sonuçları için vicinity alanı, yerin sokak adı, sokak numarası ve yerleşim yeri gibi basitleştirilmiş bir adresini içerir ancak il/eyalet, posta kodu veya ülke bilgilerini içermez.

Diğer tüm sonuçlarda, vicinity alanı, sonucun adresinde bulunan en dar siyasi (types:["political", ...]) özelliğin adını içerir.

Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır.

isteğe bağlı dize

Bu yerin yetkili web sitesi (ör. bir işletmenin ana sayfası).

isteğe bağlı boolean

Yerlerde tekerlekli sandalye kullanıcılarına uygun giriş olup olmadığını belirtir.

PlaceEditorialSummary

Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve geçerli durumlarda bu öğelerin dil kodunu da içerir. Özet metni olduğu gibi sunulmalı, değiştirilmemeli veya üzerinde oynanmamalıdır.

Alan Zorunlu Tür Açıklama
isteğe bağlı dize

Önceki alanların dili. Her zaman mevcut olmayabilir.
isteğe bağlı dize

Yerin orta uzunlukta metin özeti.

PlaceOpeningHours

Bir yerin çalışma saatlerini açıklayan nesne.

Alan Zorunlu Tür Açıklama
isteğe bağlı boolean

Yerin şu anda açık olup olmadığını gösteren bir boole değeri.

isteğe bağlı Array<PlaceOpeningHoursPeriod>

Pazar gününden başlayarak yedi günü kapsayan, kronolojik sıraya göre düzenlenmiş bir açılış dönemleri dizisi.

Daha fazla bilgi için PlaceOpeningHoursPeriod'a bakın.

isteğe bağlı Array<PlaceSpecialDay>

Önümüzdeki yedi güne karşılık gelen en fazla yedi girişten oluşan bir dizi.

Daha fazla bilgi için PlaceSpecialDay sayfasına bakın.

isteğe bağlı dize

İkincil saatlerin türünü tanımlamak için kullanılan bir tür dizesi (örneğin, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Yalnızca secondary_opening_hours için ayarlanır.

weekday_text

isteğe bağlı Array<string>

Yerin çalışma saatlerini kullanıcıların okuyabileceği metinle açıklayan bir dizeler dizisi.

PlaceOpeningHoursPeriod

Alan Zorunlu Tür Açıklama
required PlaceOpeningHoursPeriodDetail

Yerin açılış saatini açıklayan bir gün ve saat nesnesi çifti içerir.

Daha fazla bilgi için PlaceOpeningHoursPeriodDetail bölümüne bakın.

isteğe bağlı PlaceOpeningHoursPeriodDetail

Mekanın kapanış zamanını açıklayan bir gün ve saat nesnesi çifti içerebilir. Bir yer her zaman açıksa yanıtta kapanış bölümü yer almaz. Müşteriler, 7/24 açık olma durumunun 0 değerine sahip gün ve 0000 değerine sahip zaman içeren, close içermeyen bir açık dönem olarak gösterilmesine güvenebilir.

Daha fazla bilgi için PlaceOpeningHoursPeriodDetail bölümüne bakın.

PlaceSpecialDay

Alan Zorunlu Tür Açıklama
isteğe bağlı dize

Yerel saat diliminde RFC3339 biçiminde ifade edilen bir tarih (ör. 2010-12-31).

isteğe bağlı boolean

Bu gün için özel çalışma saatleri varsa doğru. true ise bu gün için en az bir istisna olduğu anlamına gelir. İstisnalar, current_opening_hours ve secondary_opening_hours alt alanlarında periods, weekday_text, open_now gibi farklı değerlerin oluşmasına neden olur. İstisnalar saatler için geçerlidir ve saatler diğer alanları oluşturmak için kullanılır.

PlaceOpeningHoursPeriodDetail

Alan Zorunlu Tür Açıklama
required sayı

Pazar gününden başlayarak haftanın günlerine karşılık gelen 0-6 arasındaki bir sayı. Örneğin, 2 sayısı Salı gününü ifade eder.

required dize

24 saatlik ssdd biçiminde günün saatini içerebilir. Değerler 0000-2359 aralığındadır. Zaman, yerin saat diliminde bildirilir.

isteğe bağlı dize

Yerel saat diliminde RFC3339 biçiminde ifade edilen bir tarih (ör. 2010-12-31).

isteğe bağlı boolean

Belirli bir dönem, yedi günlük kesme nedeniyle kısaltıldıysa doğru değerini döndürür. Bu durumda dönem, istek tarihinin gece yarısından önce başlar ve/veya son günün gece yarısında ya da sonrasında sona erer. Bu özellik, açık veya kapalı olma süresinin bu yedi günlük sınırdan sonra da devam edebileceğini gösterir.

PlacePhoto

Bir yerin fotoğrafı. Fotoğrafa, aşağıdaki desende bir URL kullanılarak Place Photo API ile erişilebilir: 

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Daha fazla bilgi için Yer Fotoğrafları başlıklı makaleyi inceleyin.

Alan Zorunlu Tür Açıklama
required sayı

Fotoğrafın yüksekliği.
required Array<string>

Fotoğrafın HTML atıfları.
required dize

Fotoğraf isteği gerçekleştirdiğinizde fotoğrafı tanımlamak için kullanılan dize.

required sayı

Fotoğrafın genişliği.

PlaceReview

Kullanıcı tarafından gönderilen yer yorumu.

Alan Zorunlu Tür Açıklama
required dize

Yorumu gönderen kullanıcının adı. Anonim yorumlar "Bir Google kullanıcısı" olarak ilişkilendirilir.

required sayı

Kullanıcının bu yer için verdiği genel puan. Bu, 1 ile 5 arasında değişen bir tam sayıdır.

required dize

Yorumun metin olarak gönderildiği zaman, geçerli zamana göre.

required sayı

Yorumun gönderildiği zaman, 1 Ocak 1970 UTC tarihinden bu yana geçen saniye sayısı olarak ölçülür.

isteğe bağlı dize

Kullanıcının Google Haritalar Yerel Rehberler profilinin URL'si (varsa).

isteğe bağlı dize

Döndürülen yorumun dilini belirten bir IETF dil kodu.Bu alan yalnızca ana dil etiketini içerir ve ülke veya bölgeyi belirten ikincil etiketi içermez. Örneğin, tüm İngilizce yorumlar "en-AU" veya "en-UK" gibi değil, "en" olarak etiketlenir.Yalnızca puan verilmiş ancak yorum metni içermeyen durumlarda bu alan boştur.

isteğe bağlı dize

Yorumun orijinal dilini belirten bir IETF dil kodu. Yorum çevrilmişse original_language != language. Bu alan yalnızca ana dil etiketini içerir. Ülkeyi veya bölgeyi belirten ikincil etiket bu alanda yer almaz. Örneğin, tüm İngilizce yorumlar "en" olarak etiketlenir, "en-AU" veya "en-UK" olarak etiketlenmez.Yalnızca puan verilmişse ve yorum metni yoksa bu alan boştur.

isteğe bağlı dize

Kullanıcının profil fotoğrafının URL'si (varsa).

text

isteğe bağlı dize

Kullanıcının yorumu. Google Yerler ile bir konumu incelerken metin yorumları isteğe bağlı olarak değerlendirilir. Bu nedenle, bu alan boş olabilir. Bu alanın temel HTML biçimlendirmesi içerebileceğini unutmayın. Örneğin, &amp; öğe referansı, ve işareti karakterini temsil edebilir.

isteğe bağlı boolean

Yorumun, yazıldığı orijinal dilden çevrilip çevrilmediğini belirten bir Boole değeri.Bir yorum çevrilmişse (true değerine karşılık gelir) Google, bunu kullanıcılarınıza belirtmenizi önerir. Örneğin, yoruma "Google tarafından çevrildi" dizesini ekleyebilirsiniz.