Recupere qualquer combinação de comodidades no quarto e no hotel, informações sobre o estabelecimento, fornecedores, imagens do estabelecimento e muito mais para um único hotelId.
Observe que o elemento options para a solicitação de listas de quartos e de hotéis pode retornar algumas ou todas as mesmas informações que este pedido independente.

Formatos de solicitação
URL em XML/REST: GET http://api.ean.com/ean-services/rs/hotel/v3/info?
Elemento pai XML: <HotelInformationRequest>

Parâmetros de solicitação

Parâmetros base
Nome Valor Obrigatório Descrição
apiExperience string sim

Use esse atributo para identificar a origem de sua solicitação. Selecione um valor aplicável do conjunto fornecido abaixo para cada solicitação enviada.

Valores:
PARTNER_CALL_CENTER - solicitação de um agente no seu call center
PARTNER_WEBSITE - solicitação de um site direcionado aos clientes
PARTNER_MOBILE_WEB - solicitação de um site formatado para dispositivos móveis
PARTNER_MOBILE_APP - solicitação de um app
PARTNER_BOT_CACHE - solicitação de um robô de cache
PARTNER_BOT_REPORTING - solicitação de um robô de relatório
PARTNER_AFFILIATE - solicitação de uma API/plataforma usada por sua própria base de afiliados

hotelId long sim Especifique o hotel desejado para a solicitação.
options string não Especifique a quantidade e o tipo de dados a retornar.  Envie um único valor ou uma combinação de valores em uma lista separada por vírgulas.
Valores:
DEFAULT Recupere todos os dados de informações de hotéis dos recursos de fornecedores. Se as opções não forem especificadas ou forem omitidas da solicitação, todos os dados disponíveis serão retornados.  Isso equivale ao envio de uma só vez de cada uma das opções separadas listadas.
HOTEL_SUMMARY Recupere somente o resumo do hotel.
HOTEL_DETAILS Recupere somente os detalhes do hotel.
SUPPLIERS Recupere somente os fornecedores deste estabelecimento.
ROOM_TYPES Recupere somente os tipos de quarto do estabelecimento.
ROOM_AMENITIES Recupere somente a lista de comodidades no quarto.
PROPERTY_AMENITIES Recupere somente a lista de comodidades no estabelecimento.
HOTEL_IMAGES Recupere somente os URLs de imagens do hotel.
Retorna os dados do hotel solicitados especificamente pelo elemento options ou todos os dados disponíveis, se não houver nenhuma opção especificada na solicitação.

Os detalhes sobre os dados do hotel retornados estão organizados abaixo de acordo com o modo como retornam dentro de cada opção.

Resposta de informações de hotéis
Elemento pai: HotelInformationResponse


Dependendo das opções especificadas na solicitação, quaisquer ou todas as informações solicitadas retornarão dentro dos objetos e matrizes a seguir.
Todas as matrizes têm um único atributo de size para indicar o número de resultados que elas contêm.
Nome Valor Descrição
HotelSummary object Elementos de resumo do estabelecimento retornado
HotelSummary.hotelId long Confirma o valor enviado na solicitação.
HotelSummary.name string Nome do hotel
HotelSummary.address1 string Endereço do hotel
HotelSummary.city string Cidade do hotel
HotelSummary.stateProvinceCode string Código de dois caracteres do estado/província que contém a cidade especificada. Retorna códigos de país somente para EUA, Canadá e Austrália.

Referências:
Códigos de estado nos EUA
Códigos de província/território no Canadá
Códigos de província/território na Austrália
  • Capital da Austrália - AC
  • Nova Gales do Sul - NW
  • Território do Norte - NO
  • Queensland - QL
  • Austrália Meridional - SA
  • Tasmânia - TS
  • Victoria - VC
  • Austrália Ocidental - WT
HotelSummary.countryCode string Código de dois caracteres ISO-3166 do país no qual o hotel está localizado.
HotelSummary.postalCode string Código postal do hotel
HotelSummary.airportCode string Código do aeroporto associado ao hotel. Normalmente não retornado.
HotelSummary.propertyCategory int Categoria do estabelecimento retornado.

Valores:
1: hotel
2: suíte
3: resort
4: condo/aluguel para temporada
5: bed & breakfast
6: tudo incluído
HotelSummary.hotelRating float Classificação (0 a 5) do hotel. Um valor 0.0 ou em branco indica que ele não tem nenhuma estrela.
HotelSummary.hotelRatingDisplay string Retorna Star ou Alternate para indicar a fonte e o tipo de exibição obrigatória do valor de hotelRating.

Atualmente, apenas os pontos de venda na Austrália devem seguir os indicadores de exibição fornecidos. Futuramente outras jurisdições serão adicionadas.

Star indica que a classificação é fornecida pela autoridade de classificação por estrelas na localidade do hotel. Use as estrelas para exibir a hotelRating.

Alternate indica hotelRating que é um valor designado pela Expedia e que não há classificação oficial disponível. Use uma exibição alternativa (por exemplo, círculos ou quadrados) para indicar que não é uma classificação oficial da autoridade local.

Retornado somente para minorRev=30 e superior.
HotelSummary.locationDescription string Local geral inserido pelo estabelecimento (por exemplo, "perto do mercado Pike Place")
HotelSummary.lowRate string Menor tarifa retornada pelo hotel em consultas recentes. Trata-se de um número estatístico e não é necessariamente a tarifa para a disponibilidade atual.
Os valores sempre são retornados em dólar americano.
HotelSummary.highRate string Maior tarifa retornada pelo hotel em consultas recentes. Trata-se de um número estatístico e não é necessariamente a tarifa para a disponibilidade atual.
Os valores sempre são retornados em dólar americano.
HotelSummary.rateCurrencyCode string Código da moeda das tarifas altas ou baixas retornadas.
HotelSummary.latitude float Coordenada de latitude do hotel.
HotelSummary.longitude float Coordenada de longitude do hotel.
HotelDetails object Elementos de detalhes do estabelecimento retornado.
HotelDetails.numberOfRooms int Número total de quartos no estabelecimento
HotelDetails.numberOfFloors int Número de andares no estabelecimento
HotelDetails.checkInTime string Horário de check-in do hotel
HotelDetails.checkOutTime string Horário de check-out do hotel
HotelDetails.extraPersonCharge float Cobrança típica por uma pessoa extra (sobre a ocupação do quarto)
HotelDetails.propertyInformation string Texto livre inserido pelo estabelecimento
HotelDetails.areaInformation string Áreas/atrações nas proximidades, geralmente incluindo distâncias do estabelecimento.
HotelDetails.propertyDescription string Texto livre de descrição inserido pelo estabelecimento
HotelDetails.hotelPolicy string Texto geral de política de hotel.
HotelDetails.depositCreditCardsAccepted string Cartões de crédito aceitos para pagamento imediato/depósito, se conhecidos.
HotelDetails.roomInformation string Informações sobre o quarto do hotel. Normalmente contém notificações e taxas.
HotelDetails.drivingDirections string Este campo foi preterido. Não use quaisquer valores retornados.
HotelDetails.checkInInstructions string Contém informações sobre taxas por pessoa extra, requisitos de identificação e qualquer outra observação relevante no check-in.
HotelDetails.specialCheckInInstructions string Contém informações importantes para o check-in, como o requisito de notificar ao estabelecimento o horário estimado de chegada. Exiba essas informações junto com as principais instruções de check-in.
HotelDetails.locationDescription string Descreve o estabelecimento e a localização relativa na cidade. Retornado somente para minorRev=25 e superior.
HotelDetails.diningDescription string Descreve as acomodações de refeição no estabelecimento. Retornado somente para minorRev=25 e superior.
HotelDetails.amenitiesDescription string Descreve as comodidades gerais no estabelecimento. Retornado somente para minorRev=25 e superior.
HotelDetails.
businessAmenitiesDescription
string Descreve comodidades voltadas para negócios no estabelecimento, por exemplo, salas de conferência. Retornado somente para minorRev=25 e superior.
HotelDetails.roomDetailDescription string Descreve as comodidades de quarto típicas. Retornado somente para minorRev=25 e superior.
HotelDetails.roomFeesDescription string Descreve todas as taxas ou depósitos específicos do quarto. Retornado somente para minorRev=25 e superior.
HotelDetails.mandatoryFeesDescription string Descreve todas as taxas de resort, incluindo outras que são mandatórias. Pode descrever os serviços cobertos por quaisquer taxas, como academia ou acesso à internet. Retornado somente para minorRev=25 e superior.
HotelDetails.
nationalRatingsDescription
string Informa a fonte da classificação de estrela do estabelecimento (por exemplo, uma agência de turismo regional ou nacional) e qualquer outro tipo de classificação recebida. Retornado somente para minorRev=25 e superior.
HotelDetails.
knowBeforeYouGoDescription
string Fornece exonerações de responsabilidade adicionais consideradas necessárias pelo estabelecimento. Retornado somente para minorRev=25 e superior.
HotelDetails.
renovationsDescription
string Descreve todas as reformas recentes no estabelecimento ou quarto. Retornado somente para minorRev=25 e superior.
Suppliers contêiner para a matriz Supplier Tem o atributo size para indicar o número de fornecedores retornados.
Suppliers.Supplier n/a

O elemento não contém nenhum valor.
Cada elemento contém atributos chainCode e ID para identificar um único fornecedor em que o hotel está ativo.
Os valores para ID podem ser decodificados da seguinte forma:
13: estabelecimentos da Expedia.com

 

RoomTypes contêiner para a matriz RoomType Contém matriz de tipo de quarto disponível no estabelecimento. Tem o atributo size para indicar o número de resultados contidos.
RoomTypes.RoomType array Contém informações sobre um único tipo de quarto. Tem atributos roomTypeId, e roomCode. roomCode corresponde ao elemento roomTypeCode retornado nas respostas da lista e do quarto.
RoomType.description string Breve descrição do quarto.
RoomType.descriptionLong string Descrição do quarto mais longa, se disponível.
RoomType.roomAmenities contêiner para a matriz RoomAmenity Contém todas as comodidades fornecidas para o quarto. Tem o atributo size para indicar o número de resultados contidos.
roomAmenities.RoomAmenity array Contém elemento de descrição para uma única comodidade. Tem o atributo amenityId. Consulte o arquivo AttributeList para ver o mapeamento de valores amenityId.
RoomAmenity.amenity string Descrição da comodidade.
PropertyAmenities Contêiner para a matriz PropertyAmenity Contém as comodidades disponíveis no estabelecimento (sem quarto específico). Tem o atributo size para indicar o número de resultados contidos.
PropertyAmenities.PropertyAmenity array Contém elemento de descrição para uma única comodidade. Tem o atributo amenityId. Consulte o arquivo AttributeList para ver o mapeamento de valores amenityId.
PropertyAmenity.amenity string Descrição da comodidade.
HotelImages contêiner para a matriz HotelImage Contém todas as imagens do estabelecimento disponíveis. Não contém fotos dos quartos. Tem o atributo size para indicar o número de resultados contidos.
Revise as  classificações de imagens para obter detalhes mais específicos sobre os dados retornados.
HotelImages.HotelImage array Contém elementos relativos ao URL e a valores de referência para uma única imagem.
HotelImage.hotelImageId long ID de imagem específica do hotel
HotelImage.name string Nome da imagem, se inserida pelo estabelecimento.
HotelImage.category int ID de categoria da imagem, se inserida pelo estabelecimento.
HotelImage.type int Indica se a imagem é uma miniatura, um mapa, etc. caption costuma ser usado pela maioria dos estabelecimentos.
HotelImage.caption string Descrição da imagem.
HotelImage.url string URL completo da imagem
HotelImage.thumbnailUrl string URL para uma miniatura da imagem, se fornecido.
HotelImage.supplierId long Indica o fornecedor da imagem. Segue o mesmo mapeamento do atributo ID do elemento Supplier.
HotelImage.width long Largura da imagem em pixels
HotelImage.height long Altura da imagem em pixels
HotelImage.byteSize long Tamanho da imagem, se disponível.